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About This Guide 


This guide describes how to use QuickFinder Server to add search functionalitv to vour Internet or 
intranet Web site. It is divided into the following sections: 


+ 


+ 


+ 


+ 


+ 


Chapter 1, “Overview of QuickFinder Server,” on page 11 

Chapter 2, “What's New or Changed in Novell QuickFinder,” on page 19 

Chapter 3, “Installing and Setting Up QuickFinder Server,” on page 21 

Chapter 4, “Migrating QuickFinder Server from NetWare to OES 11 SP2,' on page 25 
Chapter 5, 'Running QuickFinder Server in a Virtualized Environment,” on page 29 
Chapter 6, “Configuring QuickFinder Server for Novell Cluster Services,” on page 31 
Chapter 7, “Configuring QuickFinder Server Default and Services Settings,” on page 33 
Chapter 8, “Creating and Managing Virtual Search Servers,” on page 57 

Chapter 9, “Synchronizing Data Across Multiple QuickFinder Servers,” on page 99 
Chapter 10, “Optimizing Search Results,” on page 107 

Chapter 11, “Understanding Templates,” on page 123 

Chapter 12, “Working with Template Variables and Search Parameters,” on page 129 
Chapter 13, “Customizing Your Templates and Search Forms,” on page 167 

Chapter 14, “Internationalizing Search Services,” on page 171 

Chapter 15, “Security Considerations for QuickFinder Server,” on page 179 
Appendix A, “Troubleshooting QuickFinder,” on page 189 

Appendix B, “Combined Character Sets for Use with QuickFinder,” on page 193 
Appendix C, “Disabling QuickFinder Server,” on page 207 

Appendix D, “QuickFinder Packages (RPMs),” on page 209 

Appendix E, “QuickFinder Server Tips and Tricks,” on page 211 

Appendix F, “Documentation Updates,” on page 215 


Audience 


This guide is intended for anyone involved in installing, managing, and using QuickFinder Server to 
create search services. 


Feedback 


We want to hear your comments and suggestions about this manual and other documentation 
included with this product. Please use the User Comments feature at the bottom of each page of the 
online documentation. 


Documentation Updates 


For the latest version of this documentation, see the QuickFinder documentation (http:// 
www.novell.com/documentation/oes11/) Web site. 
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Overview of QuickFinder Server 


QuickFinder Server allows your users to find the information they're looking for on any of your 
public and private Web sites, your partners’ sites, any attached file systems or servers, and any 
number of additional Web sites across the Internet, all from a single search form on your Web page. 
You can easily modify the look and feel of any of the sample search results pages to match your 
corporate design. 


You can create full-text indexes of HTML, XML, PDE, Word, OpenOffice.org, and many other 
document formats in almost any language with our indexing engine, which is based on Unicode. You 
can configure and maintain your indexes remotely from anywhere on the Web with the QuickFinder 
Web-based administration module. 


Whether it's simple search solutions for your own Web sites or complex, revenue-generating search 
services for hosted environments (ASPs/ISPs), QuickFinder provides the features, scalabilitv, and 
flexibility you're looking for. 


Figure 1-1 How QuickFinder Server Works 


User enters 
search query on 
www. digitalairlines.com. 


Search is sent to 
search.digitalairlines.com 
which is hosted by 
QuickFinder Server. 


QuickFinder Server 
sends search results list 
to user. 





User clicks a search 
result to retrieve 
documents from 

www. digitalairlines.com. 


This overview includes the following topics: 


è Section 1.1, “Benefits,” on page 12 
¢ Section 1.2, “Features,” on page 12 


+ Section 1.3, “Key Components of QuickFinder Server,” on page 14 


+ 


Section 1.4, “Managing QuickFinder Server,” on page 15 
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+ Section 1.5, “Taking a Test Run: Performing a Search,” on page 17 


+ Section 1.6, “Getting Help,” on page 17 


1.1 Benefits 


More than 70% of Web site visitors on the World Wide Web use the search functionality of the Web 
sites they visit, and over 40% of Web site owners feel that the search functionality is their most 
important feature for online shopping (even more important than customer service, wish lists, 
personalization, and product information). Yet more than 50% of large Web sites (over 500,000 pages) 
and 70% of moderately sized Web sites (up to 5,000 pages) do not offer search functionality to their 
visitors. And although Internet search engines index many of these Web sites, they either cannot or 
do not index all available content. 


The top two reasons given by Web site owners for not offering search functionality are the difficulty 
in setting up a search service, and the length of time involved in doing so. 


QuickFinder Server is easy to set up and manage, and is included free with Novell Open Linux 
Enterprise Server. For more information on supported platforms, see Table 3-1, “Network Operating 
System,” on page 21. It includes a browser-based administration utility with helpful examples and 
tips right in the interface. The help system offers additional information and provides links to 
relevant topics in this manual. Unlike other search engines available on the market today, there are no 
escalated fees or limits on the number of documents indexed, the number of users who use the 
service, or the number of user transactions. 


Additionally, QuickFinder Server lets you do many things to increase your site's usability: 
¢ Gather customer metrics by reviewing customer searches to identify what your customers look 
for the most 


¢ Direct customers to the information you know they need, and away from the information you 
know they don't want 


¢ Spotlight products for marketing purposes by redirecting searches to specific Web pages 
+ Keep customers on your site longer 
+ Improve employee productivity by helping them find information more quickly 


+ Use the search page as an advertising portal (because the search page is often the most seen page 
on a Web site) 


+ Help customers navigate your Web site 


¢ Provide an information portal for customer service departments to quickly answer customer 
questions 


1.2 Features 


QuickFinder Server offers many features for both the administrator and end user. 


¢ Section 1.2.1, “QuickFinder Administrators,” on page 13 


¢ Section 1.2.2, “End Users,” on page 13 
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1.2.1 QuickFinder Administrators 


Many new features and enhancements have been added to this latest release of QuickFinder, making 
the creation and management of search services faster and easier. If you are a veteran of QuickFinder, 


see “ 


“What's New or Changed in Novell QuickFinder” on page 19 for a list of the latest features. If you 


are new to QuickFinder, take a look at what QuickFinder lets you do: 


+ 


+ 


Host search services for one or more companies or organizations 


Quickly integrate search functionality throughout your corporate internal and external Web 
sites 


Define any number of indexes for any content on your Web or network servers 
Enforce access restrictions so only authorized personnel can search for sensitive documents 
Adjust the relevance of any documents or parts of your Web site to ensure only the best results 


Define special best bets search results of only the most popular, most recent, or most important 
information 


Generate reports of all search activity for a given period, so you can learn what customers are 
looking for and what's missing from your Web site and indexes 


Customize the look and feel of search and print results in all languages 


Create themes, which are defined collections of search and print result templates that allow you 
to deploy custom look and feel virtual search servers for a specific companies or departments 


Update your search indexes automatically by using the Scheduling page 
Synchronize indexes, templates, and configuration settings of two or more QuickFinder servers 


Redirect searches for common products or terms to a specific URL, similar to the AOL keyword 
feature (http://www.amazon.com/exec/obidos/tg/detail/-/0764575023/103-5880842- 
6443046?v=glance&vi=excerpt) 


Improve search results by synonyms, redirection, stop words, best bets, relevance adjustments, 
search expansion, speller suggestions, and additional search details with user queries 


Have QuickFinder notify you by e-mail when there are errors, warnings, and query reports 


1.2.2 End Users 


Users who use your search services benefit from fast and relevant searches and the ability to print 
formatted search results. Additionally, users can do the following: 


+ 


+ 


Find the information they are looking for quickly and easily 


Search across multiple Web sites, servers, and file formats in any language, all from a single 
interface 


Print large collections of dispersed but related files as a single, coherently organized document 


Use the Highlighter feature to highlight search terms within the context of their original 
documents 


Focus their searches with wildcards and an easy-to-use query language 

Limit search results to documents created or modified recently (within any date range) 
Choose any level of detail for search results (QuickFinder supports up to 15 different fields) 
Select any number of indexes to search in 

Select the language QuickFinder should use when returning search results 


Sort search results by title, description, language, date, or URL (any of the 15 fields can be 
sorted, and you can perform multi-column sorts) 
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1.3 Key Components of QuickFinder Server 


Four key components are at the heart of the QuickFinder Server: virtual search servers, indexes, 
templates, and configuration settings. To understand how QuickFinder operates, you should 
understand the following three components. 

è Section 1.3.1, “Virtual Search Servers,” on page 14 

+ Section 1.3.2, “Indexes,” on page 15 


+ Section 1.3.3, “Templates,” on page 15 


1.3.1 Virtual Search Servers 


A virtual search server is a completely independent search solution established for a single Web site, 
department, or organization. QuickFinder Server can support any number of virtual search servers 
from a single machine, and consists of the following components:. 


+ A name and alias, which appear in your list of virtual search servers 
+ Index files containing key words and related URLs for use in generating search results 
+ Scheduled indexing events 
+ HTML-based templates for highlighter, search, and print results 
+ Log files 
+ Configuration settings, such as stop words, keyword-redirects, synonyms, and security settings 
+ Query reports 
+ Admin interface 
Each of these components is managed through the QuickFinder Server Manager, which is accessed 


through a Web browser. For more information, see Section 3.3.1, “Components of a Virtual Search 
Server,” on page 22 and Section 1.4, “Managing QuickFinder Server,” on page 15. 


Virtual search servers provide a method for categorizing similar information stores where each 
virtual search server is created for a specific purpose and audience. For example, you might create 
one virtual search server for your company’s support organization, another for its public Web site, 
and yet another for your intranet. You might break these down even further by creating more focused 
virtual search servers for groups within these organizations. 


A typical QuickFinder server might have a dozen virtual search servers, each containing several 
indexes of its own. 


Figure 1-2 A QuickFinder Server with Several Virtual Search Servers 


search.novell.com 
indexes 
e index 1 
e index 2 
e index 3 
e index 4 


search. digitalairlines.com 
indexes 
e index 1 
e index 2 
e index 3 


search.mvsql.com 
indexes 
e index 1 
e index 2 
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1.3.2 


1.3.3 


1.4 


Xou can have two or more virtual search servers share an index bv creating a duplicate index on each 
virtual search server that points to the same index directorv. In this manner, all virtual search servers 
can search a shared index in addition to their own indexes. 


To create virtual search servers and generate indexes for them, vou use the QuickFinder Server 
Manager, a browser-based utility. For more information, see Chapter 8, “Creating and Managing 
Virtual Search Servers,' on page 57. 


Indexes 


An index is a file generated bv QuickFinder Server that contains the kev words and matching URLs 
gathered bv QuickFinder Server from content located on file or Web servers. QuickFinder uses 
indexes to compile search results. Vou create one or more indexes for each virtual search server vou 
create. 


Xou can create two tvpes of indexes: file svstem and crawled. When vou want to index the contents of 
a file server, you create a file system index. When you want to index the contents of a Web server, you 
create a crawled index. 


For more information about creating indexes, see Section 8.5, “Creating Indexes,” on page 79. 


Templates 


A template is an HTML document containing one or more QuickFinder Server variables. Template 
variables are used to produce dynamic results when a user performs a search on the virtual search 
server you have defined. 


Templates can be shared across virtual search servers or each virtual search server can point to its 
own set of templates. 


For more information about templates, see Chapter 11, “Understanding Templates,” on page 123. 


Managing QuickFinder Server 


QuickFinder Server Manager is a browser-based utility you use to create and manage all virtual 
search servers and their indexes on your QuickFinder Server. 
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Figure 1-3 QuickFinder Server Manager Interface 


QuickFinder Server Manager - Mozilla Firefox 
File Edit View Go Bookmarks Tools Help 


N NOVELL: Support Entertainment CI News DI Internet Search (Reference CI Maps and Directions [3 Shopping [3 People and Companies 


QuickFinder Server Manager AA A kind 
Global Settings —— Quic maer 
An - 


Virtual Search Servers Virtual Search Server Management 


List Welcome to QuickFinder Server Manager, the web-based administration tool for managing QuickFinder solutions. (More About QuickFindes Server 
Manager] 
Add 


Virtual Search Server List 


Default Settings The virtual search server list shows all currently defined search servers. Start by creating a new virtual search server 
or by managing one from the following list. [More About the Virtual Search Server List] 

















General 


ER 
Print synch /var/lib/qfsearch/Sites/synch Manage | Delete 
wali etobiasson1.provo.novell.com 137.65.147.229 /var/lib/qfsearch/Sites/default Manage Delete 
forcory /var/lib/qfsearch/Sites/forcory Manage | Delete 


Services Settings tutorial228 tutorial /var/lib/qfsearch/Sites/tutorial228 Manage | Delete 
General www. international.org international /var/lib/qfsearch/Sites/www.international.org Manage | Delete 


Search 
Print 


Synchronization 
Add New Virtual Search Server 


www. brainshare.com brainshare /var/lib/qfsearch/Sites/www. brainshare.com Manage Delete 





@ 137.65.147.229 











QuickFinder Server Manager lets you apply default (global) settings so that each time you create a 
virtual search server, you don’t need to waste time configuring it. After you create a virtual search 
server, you can customize any of the default settings. 


See Section 1.6, “Getting Help,” on page 17 for more information about where to get help on using 
QuickFinder Server Manager. 


+ Section 1.4.1, “Accessing QuickFinder Server Manager,” on page 16 


1.4.1 Accessing QuickFinder Server Manager 


1 Enter http: //servername/qfsearch/admin (or Admin, AdminServlet, or adminservlet) in 
your Web browser’s address field. 


You can also use the IP address of your server in place of servername if the IP address is included 
in the list of aliases for that virtual search server. 


2 Enter the name and password of a valid local Linux user that has write rights to the /var/lib/ 
qfsearch directory. 


You can log in as root (with the root password), the eDirectory administrator (with the admin 
password), or the user you created during the OES install (with that user’s password). 


You can also give any eDirectory user rights to administer QuickFinder by using Linux User 
Management (LUM): 


2a Export the eDirectory user to the Linux machine. 


2b Create a www group in eDirectory and give it the same GID as the www group on the 
Linux machine. 


2c Assign the eDirectory user to the new www group. 
The eDirectory user can now access QuickFinder Manager. 
3 Click Login. 
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1.5 


1.6 


1.7 


Taking a Test Run: Performing a Search 


When you install QuickFinder Server, some of your server's content is automatically indexed and 
appears on the default search form as QuickFinder and DocRoot indexes. The first is a file svstem 
index of the QuickFinder help svstem and the second is a crawled index of the default Web server on 
your machine. 


After the server has been started, vou can open the search page through vour Web browser and 
perform a search against the content that has been automaticallv indexed. 


To test QuickFinder bv using the default search page, do the following: 


1 Type http: //domainname/qfsearch/quickfinder in your Web browser's address field, then 
press Enter. 





IMPORTANT: The URL is case sensitive. Use the exact case shown above. You can substitute 
your server's IP address for the domain name if the IP address is in list of aliases for the virtual 
search server. 





2 Type QuickFinder in the Search field, then press Enter. 





TIP: The Search form template, SearchTemplate .htmi, is stored on your server at /<searchroot>/ 
Templates where searchroot is the path where you installed QuickFinder. The default install location 
is /var/lib/qfsearch. See “Customizing Your Templates and Search Forms” on page 167 for 
information. 





Getting Help 


The QuickFinder Server Manager interface includes tips, examples, and links into the QuickFinder 
help system. Whether you're an expert or a novice QuickFinder administrator, you can get as much 
or as little information as you need, when you need it. 


When you need help using QuickFinder Server Manager, click one of the More About links found in 
some areas of the interface, or click |] to launch the help system. The help system contains 
information about each item on the current QuickFinder Server Manager page. At the bottom of each 
help topic is the More Help On the Web section containing links to this QuickFinder Server 
Administration Guide. 


What's Next 


¢ To find out what's new, see Chapter 2, “What's New or Changed in Novell QuickFinder,” on 
page 19. 


¢ To set up QuickFinder services on a physical server, see Chapter 7, “Configuring QuickFinder 
Server Default and Services Settings,” on page 33. 


+ To set up QuickFinder services on a virtual server, see Chapter 5, “Running QuickFinder Server 
in a Virtualized Environment,” on page 29. 


+ To set up QuickFinder services on a cluster, see Chapter 6, “Configuring QuickFinder Server for 
Novell Cluster Services,” on page 31. 


+ To migrate QuickFinder services from NetWare to OES 11 SP2, see Chapter 4, “Migrating 
QuickFinder Server from NetWare to OES 11 SP2,” on page 25. 
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2.1 


2.2 


2.3 


What's New or Changed in Novell 
QuickFinder 


This section describes enhancements and changes in QuickFinder since the initial release of Novell 
Open Enterprise Server (OES) 11 SP1. 


¢ Section 2.1, “What's New or Changed in QuickFinder (OES 11 SP2),” on page 19 
+ Section 2.2, “What's New or Changed in Novell QuickFinder (OES 11 SP1),” on page 19 
€ Section 2.3, “What's New or Changed in Novell QuickFinder (OES 11),” on page 19 


What's New or Changed in QuickFinder (OES 11 SP2) 


QuickFinder in OES 11 SP2 has been modified to run on 64-bit SUSE Linux Enterprise Server (SLES) 
11 SP3. There are no other changes in the OES 11 SP2 release of QuickFinder. 





IMPORTANT: Beginning with OES 11 SP2, no further enhancements are planned for QuickFinder. 
For more information, see the Notice about certain OES services. 


What's New or Changed in Novell QuickFinder (OES 11 
SP1) 


Novell QuickFinder has been modified to run on OES 11 SP1. There are no other changes in the OES 
11 SP1 release of Novell QuickFinder. 


What's New or Changed in Novell QuickFinder (OES 11) 


Novell QuickFinder has been modified to run on OES 11. There are no other changes in the OES 11 
release of Novell QuickFinder. 
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3.1 


3.2 


Installing and Setting Up QuickFinder 
Server 


You can install QuickFinder Server as a service on Novell Open Enterprise Server (OES) 2 Linux as 
explained in Table 3-1 on page 21, or you can dedicate a server to it using the Novell QuickFinder OES 
Services pattern. After installation, you can modify the global settings of your new QuickFinder 
server. Global settings make the creation of new virtual search servers easier by letting you specify 
the default settings to be used each time you create one. You can also enable or disable certain 
features, such as best bets, printing, highlighter, e-mailing, and synchronization. 

¢ Section 3.1, “Network Operating Systems Support,” on page 21 

€ Section 3.2, “Installing QuickFinder Server,” on page 21 


+ Section 3.3, “Designing Your Search Solution,” on page 22 


Network Operating Systems Support 


Table 3-1 Network Operating System 


QuickFinder Version Network Operating System 

QuickFinder 5.0.1 OES 2 Linux SP1, SP2, and SP3, OES 11 SP1, and 
SP2 

QuickFinder 5.0.0 OES 2 Linux 

QuickFinder 4.2.0 OES 1 Linux SP2 


Netware 6.5 SP6 


Installing QuickFinder Server 


If you did not install QuickFinder Server during the network operating system installation, you can 
install it anytime by using the installation media. 


For more information about the install process, see the OES 11 SP2: Installation Guide. 


+ Section 3.2.1, “Installing QuickFinder Server From the OES 11 SP2 Media,” on page 22 
€ Section 3.2.2, “QuickFinder Languages,” on page 22 
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3.2.1 


3.2.2 


3.3 


3.3.1 


Installing QuickFinder Server From the OES 11 SP2 Media 


If you did not install QuickFinder when you installed OES 11 SP2, you can install it by using the YaST 
Control Center. 
1 Launch the YaST Control Center. 
GNOME: Click Computer > More Applications > System > YaST. 
KDE: Click the menu button > System > YaST. 
2 Click Software > Add-on Product. 
3 Click Open Enterprise Server > OES Install and Configuration. 
4 On the Software Selection page, select Novell QuickFinder. 
Services that are already installed have a blue check mark in the check box next to the service. 
5 Click Accept. 
6 Change the default configuration information as prompted, then click Next. 


7 Follow the on-screen prompts to complete the installation. 


QuickFinder Languages 


QuickFinder is available in several languages. You have end-user search templates in all supported 
languages, but the QuickFinder Manager Ul and both the admin and end-user help systems are only 
available in English and the languages that are selected during the install. 


To install the additional language pack files, simply extract the contents of the QFindxx. zip files into 
the /QFSearch directory. 





NOTE: The language pack files are located in the /Products/QFSearch directory on the install CD 
and are also available from the QuickFinder product page (http://www.novell.com/products/ 
quickfinder). 





Designing Your Search Solution 


QuickFinder Server is a search service solution designed for adding powerful search capabilities to 
individual Web sites. Itis not intended to index the entire Internet. However, because many Web sites 
are comprised of multiple Web and file servers located across an enterprise, QuickFinder is designed 
to be able to index hundreds, even thousands, of Web sites and file servers as part of a single search 
solution. 


This section includes the following information: 


€ Section 3.3.1, “Components of a Virtual Search Server,” on page 22 
€ Section 3.3.2, “Deciding If You Need More Than One Virtual Search Server,” on page 23 


€ Section 3.3.3, “Becoming a Search Service Host,” on page 24 


Components of a Virtual Search Server 


Providing search services involves creating one or more virtual search servers. 


A virtual search server is a fully functioning, self-contained search service created for a particular 
audience, such as a department, organization, or a specific group of customers. 
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3.3.2 


A virtual search server tvpicallv contains its own indexes, log files, administration interface, search 
and print templates, scheduled events, virtual search server name, and optional aliases. When vou 
create a new virtual search server, a new directory is created in the /var/lib/qfsearch/Sites 
subdirectorv. This subdirectorv contains supporting configuration files and subfolders for storing 
indexes. 


When you create a new virtual search server, you create an independent search service, meaning that 
it is self-contained and doesn't depend on, or interact with, other virtual search servers. 





NOTE: Users cannot search more than one virtual search server at a time. However, a virtual search 
server can contain indexes created from content on multiple Web sites or file servers. 





Taking the time to plan your search service strategy can save you time and money and improve the 
quality of your service. 


In addition to an administrative interface, each virtual search server that you create typically contains 
one or more of the following components: 


+ Indexes: Files that hold key words and associated URLs of Web sites or file server content that 
have been indexed, or crawled. 


+ Scheduled Events: Index management, such as updating or regenerating, can be automated to 
occur at specific intervals by using the Scheduling feature. 


¢ Search and Print Results Templates: Templates that are populated with the results of a search 
and then displayed to the user. Depending on which templates are used, the level of detail 
displayed in search and print results varies. 


+ Themes: A collection of templates that share a common look and feel and that work together to 
provide a rich end-user search experience. A theme includes your search page, search and print 
results pages, and response and error message pages. 


+ Configuration Settings: Includes information such as stop words, keyword-redirects, 
synonyms, and security settings. 


+ Query reports: Summary reports, in HTML format, of the query log data. 


Deciding If You Need More Than One Virtual Search Server 


To determine if you need more than one virtual search server, answer the following questions: 


(O Do you want to host search services for multiple, independent organizations or Web sites? 
O Do you want to consolidate multiple QuickFinder servers onto a single machine? 


(O Do you need to prevent users from being able to search across multiple indexes at the same 
time? 


If you answered yes to any of these, you probably need to create more than one virtual search server. 
Otherwise, a single virtual search server might suffice. For more information about virtual search 
servers, see Chapter 8, “Creating and Managing Virtual Search Servers,” on page 57. 
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3.3.3 Becoming a Search Service Host 


Companies who want customers to find information about their products typically outsource this 
function to search service companies. With QuickFinder Server, you can offer professional search 
services for other companies. Using a single installation of QuickFinder, you can host many virtual 
search servers simultaneously, which means that you could use the same server to host search 
services for several client or customer Web sites. 


The following diagram shows how a search query on the Web site www.digitalairlines.com is sent to 
a QuickFinder server on the domain search.digitalairlines.com. 


Figure 3-1 How a Search Query is Sent to the QuickFinder Server and Processed 


(1) User enters 
search query on 


www. digitalairlines.com. 


Search is sent to 

search. digitalairlines.com 
which is hosted by 
QuickFinder Server. 


QuickFinder Server 
sends search results list 
to user. 





O User clicks a search 
result to retrieve 
documents from 
www. digitalairlines.com. 
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4.1 


4.1.1 


4.1.2 


Migrating QuickFinder Server from 
NetWare to OES 11 SP2 


This section provides detailed instructions on how to migrate QuickFinder Server from NetWare to 
Novell Open Enterprise Server (OES) 11 SP2. For general information about the OES migration tools, 
see 'Overview' in the OES 11 SP2: Migration Tool Administration Guide. 


¢ Section 4.1, “Coexistence,” on page 25 
¢ Section 4.2, “Migration Procedure,” on page 26 


* Section 4.3, “Post-Migration Considerations,” on page 27 


Coexistence 


This section provides information regarding the coexistence of QuickFinder Server 5.0 with existing 
NetWare or Linux networks, and with previous versions of the product. 


+ Section 4.1.1, “Compatibility,” on page 25 


¢ Section 4.1.2, “Coexistence Issues,” on page 25 


Compatibility 


The following table summarizes the compatibility of QuickFinder with various network operating 
systems: 


Table 4-1 QuickFinder Compatibility 


Operating System Compatible Versions 
NetWare NetWare 6.5 SP3 or later 
Linux SUSE Linux Enterprise Server 8 


SUSE Linux Enterprise Server 9 SP1 or later 


SUSE Linux Enterprise Server 10 or later 


Coexistence Issues 


QuickFinder Server and Web Search Server can coexist in your network environment, but should not 
be used on the same server. 
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4,2 Migration Procedure 


Use the following steps to migrate QuickFinder Server from a NetWare server to an OES 11 SP2 
server. 





NOTE: Migrating from QuickFinder Server running on NetWare 6.5 SP8 to OES 11 SP2 replaces any 
indexes or configurations made on the Linux server. If vou want to merge vour changes from 
NetWare to Linux, vou must manuallv re-create the changes bv using the QuickFinder Server 
Manager. 





1 Install QuickFinder Server on an OES 11 SP2 server. 
For more information, see Section 3.2.1, “Installing QuickFinder Server From the OES 11 SP2 
Media,' on page 22. 

2 Access QuickFinder Server Manager on the NetWare server, then click Global Settings (&) on 
the top toolbar. 


See “Accessing QuickFinder Server Manager on NetWare” in the NW 6.5 SP8 Novell QuickFinder 
Server 5.0 Administration Guide for more information. 


3 Write down the paths for each virtual search server displayed in the Location column. 
4 On the OES 11 SP2 server, mount the NetWare server (you can use ncpmount). 
5 Make a backup of /var/lib/gfsearch/SiteList.properties. 
Make sure that you don't have a file with this name as a backup on the NetWare server. 


6 Copy all .properties and Cron. jobs files from the root directory svs: /qfsearchon the 
NetWare server to the /var/lib/qfsearch directory on the OES 11 SP2 server. 


7 Copy svs: /qfsearch/Sites and all of its subdirectories to the /var/lib/qfsearch/Sites 
directory on the OES 11 SP2 server. 


8 Copy sys: /qfsearch/Templates and all of its subdirectories to the /var/lib/qfsearch/ 
Templates directory on the OES 11 SP2 server. 


9 If any of the paths listed in Step 3 are not under sys: /qfsearch (for example, if you installed a 
virtual search server somewhere other than the default location), you must also copy those paths 
to Linux. 


For example, if you have the path sys: /SearchSites/PartnerSite, you must copy it to the 
Linux server. You could copy itto /var/opt/SearchSites/PartnerSite or /var/lib/ 
qfsearch/Sites/PartnerSite. 


10 Edit all NetWare paths in /var/lib/qfsearch/SiteList .properties to reflect the new Linux 
paths (such as sys:/qfsearch to /var/lib/qfsearch, or as in Step 9, sys: /SearchSites/ 
PartnerSite to /var/opt/SearchSites/PartnerSite. 


Some paths might have one or two backslashes (\) that must be replaced with one forward slash 
(/). For example, sys: \\qfsearch\\docs needs to be change to /var/lib/qfsearch/docs. 


Linux paths are case sensitive. 


11 Update all NetWare paths in the properties and configuration files copied in the steps above to 
the Linux paths, and update any DNS names. 


The following is a list of files that must be updated: 
+ AdminServlet .properties 
+ Cron.jobs 


+ Sites/Highlighter.properties 
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+ Sites/Print.properties 
+ Sites/Search.properties 
For each of the virtual search servers, modify the following; 
+ gfind.cfg 
+ Any of the above .properties files, if they exist. 


The names of most properties files are mixed case, so make sure the files copied from NetWare 
are the correct case. You can compare them to the .properties.sample files on Linux. 


You might also need to update paths in templates. If you have problems such as a template not 
being found or some properties not being set properly, check the case of the filename. Linux 
filenames are case sensitive. 


If you modified any “file” index paths to index directories on the Linux server, that index must 
be regenerated. 


12 After all the files have been modified, run the following commands to set the access rights and 
owner/groups so that the QuickFinder engine has rights to access the files: 


chown -R root:www /var/lib/qfsearch 


chmod -R 770 /var/lib/qfsearch 


4.3 Post-Migration Considerations 


After upgrading from a previous version of Web Search or QuickFinder Server, be aware of the 
following issues: 


+ Ifyou are migrating from an existing NetWare server with Web Search Server to a new Linux 
server with QuickFinder Server, you must manually copy files from NetWare to Linux so that 
everything doesn’t need to be newly created. 


+ QuickFinder Server 5.0 indexes are not compatible with previous version of QuickFinder Server. 
The indexes must be regenerated, and you cannot synchronize QuickFinder Server 5.0 indexes 
with indexes from a previous version of QuickFinder Server (and vice-versa). 


+ The new template files are not placed in the <qfsearch>/Templates directory because this 
overwrites any changes you might have made to them. 


Instead, the new template files are placed in the <qfsearch>/Templates/Samples directory. To 
take advantage of the functionality the new templates provide, copy the template files from the 
<qfsearch>Templates/Samples directory to the <qfsearch>/Templates directory. 
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Running QuickFinder Server in a 
Virtualized Environment 


QuickFinder Server runs in a virtualized environment just as it does on a physical Novell Open 
Enterprise 11 server, and requires no special configuration or other changes. However, if you want to 
run QuickFinder within a virtual machine and intend to index large amounts of data, you need to 
assign at least 2 GB of memory to the virtual machine. 


To get started with virtualization, see “Introduction to Xen Virtualization” in the Virtualization with 
Xen guide. 


To get started with third-party virtualization platforms, such as Hyper-V from Microsoft and the 
different VMware product offerings, refer to the documentation for the product you are using. 


For information on setting up virtualized OES 11 SP2, see “Installing, Upgrading, or Updating OES 
on a VM” in the OES 11 SP2: Installation Guide guide. 
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Configuring QuickFinder Server for 
Novell Cluster Services 


The QuickFinder Server Svnchronization feature provides fault tolerance and load balancing. To 
include failover capabilities, vou can enable QuickFinder for clustering. 


To configure QuickFinder Server to work with Novell Cluster Services, vou should install 
QuickFinder Server on each server in your cluster. This allows the installation program to correctly 
register QuickFinder Server with each of vour server's Web and application servers. 


Before vou begin, on one Linux node in the Novell Cluster Services cluster, create a Linux POSIX 
volume cluster resource where all of the indexes and virtual search server settings will be located. For 
instructions, see “Configuring and Managing Cluster Resources for Shared LVM Volume Groups” in 
the OES 11 SP2: Novell Cluster Services for Linux Administration Guide. 


You can use virtual search servers to enable QuickFinder Server to work in a cluster. 


1 Make the Linux POSIX volume cluster resource active on an OES 11 SP2 node in the cluster. 
2 Ifitis not already installed, install QuickFinder on that server. 


3 Inthe QuickFinder Server Manager, click the Global Settings icon, then click Add New Virtual 
Search Server. 


3a In the Name field, specify the DNS name of the cluster server. 


3b In the Location field, specify the volume and path on the shared cluster volume where all the 
indexes and virtual search server settings will be located. 


3c Click Add. 
4 Set up and create any indexes that you want clustered in that virtual search server. 
For more information, see “Creating Indexes” on page 79. 


5 Move the Linux POSIX volume cluster resource to the other server and install QuickFinder 
Server on that server. 


6 Add a new virtual search server and give it the same name and location as the virtual search 
server you created in Step 3. 


The settings already created on the shared volume are displayed. 
7 Repeat Step 5 and Step 6 for each of the remaining nodes in the cluster where you want to fail 
over the Linux POSIX volume cluster resource. 


To do a search on the cluster volume, enter http: //DNS_CLUSTER/qfsearch/search. QuickFinder 
Server sees the DNS and knows which virtual search server to send the request to. 





IMPORTANT: All scheduling information is stored in /var/lib/qfsearch, so you must set up 
scheduling on each server. When the cluster node is not active on one of the servers, the scheduled 
indexes on that server fail. However, the server that has the Linux POSIX volume cluster resource 
generates the indexes. 
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Configuring QuickFinder Server Default 
and Services Settings 


Before vou start creating virtual search servers and building indexes for them, vou might want to 
modifv the global settings of vour search server, which affect all virtual search servers vou create. 


QuickFinder Server Manager's home page displavs a list of all virtual search servers that exist on 
your QuickFinder Server (see Figure 7-1). This home page is called Global Settings because the 
changes you make from this page affect all new virtual search servers that you create, and they also 
affect the functionality of the servlets that provide the QuickFinder services. 


Figure 7-1 QuickFinder Server Virtual Search Global Settings Page 


QuickFinder Server Manager - Mozilla Firefox 
File Edit View Go Bookmarks Tools Help 
N NOVELL: Support G Entertainment CI News DI Internet Search CI Reference CI Maps and Directions [3 Shopping CI People and Companies 
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Virtual Search Servers Virtual Search Server Management 


List Welcome to QuickFinder Server Manager, the web-based administration tool for managing QuickFinder solutions. [More About QuickFinder Server 
Manager 
Add 


Virtual Search Server List 


Default Settings The virtual search server list shows all currently defined search servers. Start by creating a new virtual search server 
or by managing one from the following list. [More About the Virtual Search Server List] 
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For instructions about accessing the QuickFinder Server Manager, which is the interface for 
configuring and managing QuickFinder, see Section 1.4.1, “Accessing QuickFinder Server Manager,” 
on page 16. 


This section contains the following topics: 


+ Section 7.1, “Differences between Default and Services Settings,” on page 34 


+ Section 7.2, “Configuring Default Settings,” on page 34 
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7.1 


7.2 


72.4 


+ Section 7.3, “Configuring Services Settings,” on page 47 


¢ Section 7.4, “Updating QuickFinder Server Software,” on page 55 


Differences between Default and Services Settings 


The Global Settings page —also called the home page because it is the default page that appears when 
you first log in to QuickFinder Server Manager—is for use by the global search administrator, or the 
person who has administrative rights over the QuickFinder Server. 


The Global Settings page has two groups of settings: Default Settings and Services Settings. The first 
lets you specify default settings for new virtual search servers, and the second gives you 
administrative control of all virtual search servers. 


Configuring Default Settings 


As the name implies, Default Settings lets you specify the default settings for all new virtual search 
servers. For example, if you set the default query encoding from the General Settings page to 
Unicode (UTF-8), any new virtual search server you create after making this change defaults to the 
new setting. After you create a new virtual search server, you can then change its default settings. 


For more information, see Section 7.2.1, “Configuring Default General Settings,” on page 34 and 
Chapter 8, “Creating and Managing Virtual Search Servers,” on page 57. 


Default settings are meant to make the creation of new virtual search servers easier. By letting you 
specify common settings for use by all new virtual search servers, you don't need to waste time 
making the same configuration changes each time you create a new virtual search server. 


Before you begin making changes, start by exploring QuickFinder so that you can decide what the 
most common configuration settings should be for your situation. You might start by planning your 
search solution to get ideas about the purpose for it, who will be using it, what languages it must 
support, and so on. For additional information about planning your search solution before you begin 
creating it, see Section 3.3, “Designing Your Search Solution,” on page 22. 


Existing virtual search servers are not affected by these changes. 


+ Section 7.2.1, “Configuring Default General Settings,” on page 34 
+ Section 7.2.2, “Configuring Default Search Settings,” on page 38 
+ Section 7.2.3, “Configuring Default Print Settings,” on page 41 

+ Section 7.2.4, “Configuring Default Index Settings,” on page 43 

+ Section 7.2.5, “Configuring Default Security Settings,” on page 46 


Configuring Default General Settings 


General Settings lets you modify general query, response, error log, and e-mail settings. 
e “Modifying Query Settings” on page 35 
+ “Modifying Default Query Logging Settings” on page 36 
+ “Modifying Response Settings” on page 37 
e “Modifying Error Log Settings” on page 37 
e “Modifying E-Mail Settings” on page 37 
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Modifving Querv Settings 


1 On the QuickFinder Server Manager's Global Settings page, click General under Default Settings. 


2 From the Default query encoding drop-down list, select an encoding that represents the character 
set encoding that the users of your search services are most likely to use. 


QuickFinder Server Manager - Mozilla Firefox 
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Global Settings i y a QuickF inder 
EAL. 
Virtual Search Servers General Settings 


List This page lets you specify default general settings to be used when creating a new virtual search server. General settings apply to 
Add both search and print services. Existing virtual search servers are not affected. When you create a new virtual search server and 
—= make changes to its search settings, those changes override these default settings. [More About Global General Settings] 


Default Settings Querv Settings 


Default querv encoding: Unicode (UTF-8) sl 
Maximum querv duration (seconds): fo 


Enable stop-words processing: FYes C No. EditList 
Enable svnonvm-enhanced search results: FYes C No. EditList 


Querv Logging 


Enable querv logging: f'Ves F No 


Exclude these IP addresses: 
Se ZI Example: <- exclude this specific IP 
Synchronization 111.111.111.111 address 
Example: 111.111. <- exclude all IP addresses 


with this prefix 


Log period: Monthly v| 


E-mail log reports: C Yes “No 
Reports are automatically generated when a logging 
period ends. Select Yes and enter one or more 
recipients to e-mail the reports as they become 
available. 


UTF-8 is a good choice for most situations because it works for all languages. However, there 
might be times you need to select an encoding other than UTF-8. For example, if you are hosting 
a Japanese Web site for a Japanese-only audience, you don't want to choose UTF-8 because it 
needs 3 bytes for most Japanese characters. In this case, a better choice might be Shift_JIS or ISO- 
2022-JP. For more information about character sets, see Appendix B, “Combined Character Sets 
for Use with QuickFinder,” on page 193. 











3 In the Maximum query duration field, specify the maximum number of seconds before 
QuickFinder should end a query, regardless of whether a search has been completed. 


This option is one of several methods that enable you to protect your server's resources from 
processing rogue searches, which are sometimes intended to harm your service by consuming 
server resources. For more information, see Appendix 15, “Security Considerations for 
QuickFinder Server,” on page 179. 


4 (Optional) Click Yes next to Enable stop-words processing if you want QuickFinder to ignore 
insignificant words, such as adverbs, conjunctions, or prepositions, in a user's search query. 


For information about stop words and how to edit the default list of stop words, see “Using Stop 
Words Processing to Improve Search Speed” on page 112. 


5 (Optional) Click Yes next to enable synonym enhanced search results if you want QuickFinder to 
expand search queries by looking for synonyms of the original search terms. 
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Svnonvm enhancement is not performed within the FileFilter section of a search. For more 
information about synonym enhanced searches, see “Using Synonyms to Broaden Search 
Results' on page 114. 


6 Click Apply Settings. 


Modifving Default Querv Logging Settings 


When querv logging is enabled (it is enabled bv default), it captures manv details about user queries, 
including total number of searches performed (for the current logging period), top 100 search terms, 
load statistics, most popular indexes, and the number of print jobs and highlights performed. It also 
provides information about queries that resulted in a “not found” error message. This information 
can be used to improve the performance of your search services, or to identify areas of your site that 
could be improved. 


1 On the QuickFinder Server Manager's Global Settings page, click General under Default Settings. 
2 Click Yes next to Enable query logging. 
To disable query logging, click No next to Enable query logging. 


3 In the Exclude these IP addresses field, specify one or more IP addresses of the computers that you 
want excluded from the query log, separating each additional address by a space or hard return. 


This feature enables you to eliminate query logging for searches originating within your 
organization. Keeping query log information gathered from customer queries separate from log 
information related to employees of your own company can help you identify issues that 
directly affect your customers. 


4 From the Log period drop-down list, select a log period of either Monthly or Weekly. 


QuickFinder records search requests in the current log file until the end of the specified period. 
When QuickFinder switches to a new log file, a report for the old log file is automatically 
generated. 


5 In the E-mail log reports field, specify one or more e-mail addresses where you want copies of 
each new log report sent, separating each additional address by a space or hard return. 


If this field does not appear, itis because you have disabled e-mail services on your QuickFinder 
Server. To enable e-mail services, go to the QuickFinder Global Settings page and click Services 
Settings > General > E-Mail Settings. 


6 To view an existing log report, select one from the Available log reports field, then click View 
Report. 


If there are no logs listed, you have not yet generated a log report. Click Generate Current to 
create a report of the current (not yet completed) log period. Depending on the amount of 
information in the logs, this process can take anywhere from a few seconds up to several hours 
to complete. After a new report is generated, it appears in this field. 


7 (Optional) If you want to specify a different logging template, specify the name of the template 
in the Template to use when generating reports field. 


QuickFinder provides the following templates at install time: 
+ ReportTemplate.html: Produces an HTML summary report of the query log data. 


+ ExportTemplate.xml: Exports the raw query log data into an XML file format that can be 
easily consumed by other reporting tools such as Crystal Reports, databases, and executive 
information systems. 
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The templates are located in the virtual search server directorv (for example /qfsearch/sites/ 
default), and the logs and reports are located in /qfsearch/sites/default/logs. See 
Section 12.11, “Query Report Template Variables,” on page 144 for more information on editing 
or creating you own query report templates. 


8 Click Apply Settings. 


Modifying Response Settings 


1 On the QuickFinder Server Manager's Global Settings page, click General under Default Settings. 


2 Under Response Settings, select an output encoding from the Default encoding for response pages 
drop-down list. 


This setting specifies the encoding QuickFinder should use when responding to user queries by 
using the search and print results templates, and the error and response messages templates. 


3 Specify the maximum number of potential search results (hits) in the Refuse queries if potential hits 
exceed field that QuickFinder allows before cancelling the search. 


A potential hit refers to all initial occurrences of a user's search terms in an index. After all 
matches between search terms and their related documents are found in the index, filters are 
applied to narrow the list of search results. Determining a user's access rights to individual files 
when performing a rights-based search is an example of a filter. 


If a search term is too vague, it can produce an excessively large list of potential hits, which can 
place an unnecessary burden on your server. By limiting the number of potential hits allowed, 
you can reduce the processing overhead that is otherwise placed on your server. If a user's 
search query produces a number of potential hits that exceed the number you specify, a message 
is returned to them suggesting that they be more specific in their search query. 

Although a hit might be found in the index, it might not yet be authorized by NetIQ eDirectory 
and the file system to determine access rights. The number you specify here is critical in 
situations where a user might have access to only a few documents in an index that contains 
thousands of files. 


4 Click Apply Settings. 


Modifying Error Log Settings 


1 On the QuickFinder Server Manager's Global Settings page, click General under Default Settings. 


2 In the Maximum log size field, specify the maximum size (in bytes) that QuickFinder should 
allow the log file to grow to. 


Depending on the number of visitors that your virtual search servers hosts, log files can become 
large. This setting protects your svstem's hard drive resources. 


The number you specify here is divided evenly between two log files. For example, if you 
specify 30000, each log file allows up to 15000 bytes of logged data. This ensures that you always 
have at least 15000 bytes of logged synchronization data. 


3 Click Apply Settings. 


Modifying E-Mail Settings 


1 On the QuickFinder Server Manager's Global Settings page, click General under Default Settings. 


2 (Optional) Click Yes next to Enable e-mail services if you want QuickFinder to generate an e-mail 
message when errors occur during the generation (or regeneration) of your virtual search 
server's indexes, or when your indexes are being synchronized with other QuickFinder servers. 
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IMPORTANT: If the E-mail Settings feature is not visible, you must enable it from the Services 
Settings > General page. See “Configuring General Services Settings” on page 48. 





3 (Optional) If you enabled e-mail services, type one or more e-mail addresses indicating where 
error messages should be sent. 


The addresses you specify here become default addresses for each virtual search server. They 
can be removed from within each virtual search server, or more addresses can be added. 
Separate each address with a space, comma, semicolon, or return. 


4 Click Apply Settings. 


7.2.2 Configuring Default Search Settings 


Default Search Settings lets you modify default search query, response, and template settings for all 
new virtual search servers. 


+ “Modifying Search Query Settings” on page 38 

€ “Modifying Search Response Settings” on page 39 

+ “Customizing or Deleting Highlighter Color Schemes” on page 40 
€ “Modifying Search Template Settings” on page 40 


Modifying Search Query Settings 


1 On the QuickFinder Server Manager's Global Settings page, click Search under Default Settings. 


2 (Optional) Under Query Settings, click Yes next to Enable search term redirection if you want to 
redirect specific queries to specific URLs. 


QuickFinder Server Manager - Mozilla Firefox 
File Edit View Go Bookmarks Tools Help 
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QuickFinder Server Manag 
Global Settings 


Virtual Search Servers Search Settings 


This page lets you specify default search settings to be used when creating a new virtual search server. Existing virtual search 
servers are not affected. When you create a new virtual search server and make changes to its search settings, those changes 
override these default settings. [More About Search Settings] 


Default Settings Query Settings 
General Enable search term redirection: C Yes No EditList 


Search 
Print Enable Best Bets search results: C Yes © No 


dex Show Best Bets searches by default “Yes No 
ecuri Maximum number of Best Bets results: f 
Minimum Best Bets relevance: p 


Response Settings 


Default number of results to displav: ps 


ae ra Maximum number of results per page: [200 
ovnchronization i ; 
ae Highest allowed result number: 1000 


Enable speller: © Yes © No. EditList 
Spell check if total hits is below: ps 


Enable search terms Highlighter: @ Yes C No. Edit Colors 
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For example, searching for one net on www.novell.com redirects vour browser to a special page 
designed to emphasize the Novell One Net strategv, rather than returning the search results 


page. 
For more information about other QuickFinder features vou can use to improve the search 
service experience for your users, see Chapter 10, “Optimizing Search Results,” on page 107. 


3 (Optional) Click Yes next to Enable Best Bets search results if you want a specialized set of search 
results added to the top of the search results list. 


Best bets is another method of helping users find what they are looking for more quickly. For 
more information, see “Using Best Bets to Help Users Find the Right Information” on page 113. 


4 If you enabled best bets, click Yes next to Show Best Bets searches by default if you want the best 
bets results list to always appear on the search results page. 


Click No if you want users to request the best bets results list at the time of their search request. 


5 In the Maximum number of Best Bets results field, type the maximum number of best bets results to 
be included per search results page. 


Consider keeping the list relatively short because the purpose of best bets is to narrow the search 
for users. 


6 Inthe Minimum Best Bets relevance field, type the number of low relevance documents you want 
removed from the best bets display. 


7 Click Apply Settings. 


Modifying Search Response Settings 


1 On the QuickFinder Server Manager's Global Settings page, click Search under Default Settings. 


2 Under Response Settings, specify the number of search results in the Default number of results to 
display field that you want included on search results pages. 


For example, if you set this to 25 (the default setting) and the number of hits in a return was 200, 
QuickFinder only returns 25 hits per search results page. 


3 Seta limit on the number of results allowed at one time on the results page by specifying a 
number in the Maximum number of results to display field. 


Use this setting (and the Highest Allowed Result Number setting) to protect your server from users 
who might attempt to set the number of results excessively high in order to intentionally abuse 

your computer. This can be done using available query parameters such as & NumHits=number 

and &StartHit=number. This setting blocks the use of such parameters. 


4 Specify the highest number of search results that can be returned to a user query in the Highest 
allowed result number field. 


5 (Optional) Click Yes next to Enable speller to have QuickFinder provide alternate spelling 
suggestions for search terms. 


Use the Spell check if total hits is below option to have QuickFinder spell-check search terms if the 
number of search results is lower than the number specified. 


6 (Optional) Click Yes next to Enable search terms highlighter if you want users' search terms to be 
highlighted in the documents returned in a search. 


When the highlighter is enabled, a special icon appears on the search results page that users can 
click to show highlighted words in context. For instructions about how to customize the colors 
used by the highlighter, see “Customizing or Deleting Highlighter Color Schemes” on page 40. 


7 Click Apply Settings. 
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Customizing or Deleting Highlighter Color Schemes 


1 On the QuickFinder Server Manager's Global Settings page, click Search under Default Settings. 
2 Click Apply Settings > Back to Search Settings to save any changes you have made. 
Clicking Edit Colors causes any unsaved changes to be lost 
3 Under Response Settings, click Edit Colors next to Enable search terms highlighter. 
4 Click the Color button in the Foreground and Background columns to select a color. 
or 


Type the color value (such as #RRGGBB) or color names. You can review your selections in the 
Preview column. 
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A i T QuickFinder 


Global Settings 


Virtual Search Servers Edit Highlight Colors 


The following list of colors is used during search term highlighting. The colors are used in the order in which they are defined 
below. The first color is used to highlight the first search term entered by the end user, the second color for the 2nd search term, 
etc. The list of highlight colors is repeated if the user specifies more search terms than defined highlighter colors. 

Any highlight colors created in Global Settings become the default colors for newly created virtual search servers. Individual 
search servers can override globally created highlighter colors. [More About Search Term Highlight 


Color 1: Foreground Background Preview: Delete 
[WHITE HE [sccocoo BB) word EE word 





Color 2: Foreground Background Preview: Delete 


BLACK BE] FFABEDAA BB word highlighted word 


Color 3: Foreground Background Preview: Delete 


BLACK HB) frospse9 EB word highlighted word 


Color 4: Foreground Background Preview: Delete 


Synchronization [WHITE El ĦA2A83D BB word TFT word 


Color 5: Foreground Background Preview: Delete 


BLACK BB) frsoc7ca ME word highlighted word 
Add More Colors... 


U «| 














5 If you want to define additional colors, click Add More Colors. 


Because a user can search for more than one search term at a time, you can define multiple colors 
so that each search term appears in a different color. For example, if a user searched for “HTTP 
AND Apache”, the terms appear highlighted in the documents where they originated. The 
colors are used in the order in which they are defined here. 


6 To remove a defined color set, click Delete in the row of the color set you want removed. 
7 Click Apply. 


Modifying Search Template Settings 


1 On the QuickFinder Server Manager's Global Settings page, click Search under Default Settings. 


2 Under Template Settings, specify a path to where your QuickFinder templates are stored in the 
Templates Directory field. 
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The default path is /var/lib/qfsearch/Templates. If you have created custom templates, or 
you want to keep your templates elsewhere, specify the path here so that QuickFinder knows 
where the templates are. 


3 From the Default encoding for templates drop-down list, select the character set that your 
templates are written in. 


This value is used with templates that do not specify an encoding. Encodings found in templates 
that do not match the encoding you specify here override this encoding. 


4 In the Default search page template field, specify the filename of the search page template you want 
to use. 


If you have created a custom template and want QuickFinder to use it as your search page, 
specify its name in this field. 


5 In the Default search results template field, specify the filename of the search results template you 
want to use. 


As with the default search page template, if you have created a custom search results template 
and want QuickFinder to use it as your default search results page, specify its name in this field. 


6 Inthe Default highlighter template field, specify the filename of the highlighter template you want 
to use. 


As with the default search and results page templates, if you have created a custom highlighter 
template and want QuickFinder to use it as your default highlighter page, specify its name in 
this field. 


7 In the Template to use if no results returned field, specify the filename of the template that 
QuickFinder should return if no results are found. 


8 Inthe Template to use if error occurs field, specify the filename of the template that QuickFinder 
should return if there are errors while processing a user's query. 


9 Click Apply Settings. 


For more information about QuickFinder templates, see Chapter 11, “Understanding Templates,” on 
page 123. 


7.2.3 Configuring Default Print Settings 


Default Print Settings lets you modify default print results and print template settings for all new 
virtual search servers. 


e “Modifying Default Print Result Settings” on page 41 
e “Modifying Default Print Template Settings” on page 42 


Modifying Default Print Result Settings 


1 On the QuickFinder Server Manager’s Global Settings page, click Print under Default Settings. 


2 Under Print Results Settings, specify the number of print results in the Default number of results to 
print field that you want displayed on each print results page. 
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This page lets you specify default print settings to be used when creating a new virtual search server. Existing virtual search servers 


are not affected. When you create a new virtual search server and make changes to its print settings, those changes override these 
default settings. [More About Global Prirt Settings] 


Default Settings Print Result Settings 


Default number of results to print: Bs 
Search Maximum number of results to print: [200 — 
Print Highest allowed result number: frooo — 
Index Maximum print job size (bytes): [2097152 — 
Security Print job size warning (bytes): froz400 — 


Services Settings Template Settings 
Templates directorv: Ivarlibigfsearch/T emplates 
Default encoding for templates: Unicode (UTF-8) sl 
RU Default print results template: PPrintResultfemplate.htmi 
Synchronization z - - 
Template to use if no results returned: [PrintResultNoHitsTemplate.htmi 
Template to use if more information needed: [ResponseMessageTemplate html 
Template to use if error occurs: ErrorMessageTemplate. html 


Apply Settings 


General 





For example, if you set this to 25 (which is the default setting) and the number of hits in a return 
was 200, QuickFinder only returns 25 hits per print results page at a time. 


3 Set a limit on the number of results allowed at one time on the results page by specifying a 
number in the Maximum number of results to print field. 


4 Specify the highest number of search results that can be returned to a user query in the Highest 
allowed result number field. 


5 To limit the size of a print job, specify the largest print job size that QuickFinder should allow in 
the Maximum print job size field. 


Any users requesting a print job larger than this value receive a message informing them that the 
request was too large. 


This is a useful feature for administrators who want to keep down the size of print jobs in their 
own companies, departments, or organizations. 


6 To have users notified when a print job exceeds a certain size, specify the print job size in the 
Print job size warning field. 


By default, this message is sent by using the ResponseMessageTemplate.html file and is 
intended as a warning to users that they are exceeding the allowed print job size. It then prompts 
the user to confirm the print job before continuing. 


7 Click Apply Settings. 
Modifying Default Print Template Settings 


1 On the QuickFinder Server Manager’s Global Settings page, click Print under Default Settings. 


2 Under Template Settings, specify a path in the Templates directory field to where your QuickFinder 
templates are stored. 
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1.2.4 


The default path is /var/lib/qfsearch/Templates. If you have created custom templates, or if 
you want to keep your templates elsewhere, specify the path here so that QuickFinder knows 
where the templates are. 


3 From the Default encoding for templates drop-down list, select the character set that your 
templates are written in. 


This value is used with templates that do not specify an encoding. Encodings found in templates 
that do not match the encoding you specify here override this encoding. 


4 Inthe Default print results template field, specify the filename of the print results template you 
want to use. 


If you have created a custom print results template and want QuickFinder to use it when 
returning print results, specify its name in this field. 


5 Inthe Template to use if no results returned field, specify the filename of the template that 
QuickFinder should return if no print results match a user’s query. 


6 Inthe Template to use if more information is needed field, specify the filename of the template to be 
sent back to users whose print jobs exceed the size you specify in the Print Job Size field. (See 
Step 6 in “Modifying Default Print Result Settings” on page 41.) 


7 Inthe Template to use if error occurs field, specify the filename of the template that QuickFinder 
should return if there are errors while processing a user’s print query. 


8 Click Apply Settings. 


Configuring Default Index Settings 


These settings are intended to make the process of creating indexes even easier by letting you 
configure common settings as default settings. This saves you time because you don't need to make 
the same selections each time you create a new index. 

e “Modifying Default Index Settings” on page 43 

+ “Allowing Indexes to Be Used with QuickFinder Synchronization” on page 45 

+ “Enabling or Disabling User Authentication When Accessing Indexes” on page 45 


Modifying Default Index Settings 


1 On the QuickFinder Server Manager's Global Settings page, click Index under Default Settings. 


2 Select the type of index that you want as the default index type on the Indexing Management 
page. 
Each time you create a new index, the index type you select here is automatically selected. You 
can change the default index type when you create an index. 
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Index Settings 


This page lets you specify default index settings to be used when creating a new virtual search server. Existing virtual search 
servers are not affected. When you create a new virtual search server and make changes to its index settings, those changes 
override these default settings. [More About Global Index Settings] 


General Settings 


Index type: G Crawled € File system 
Obey Robots.txt exclusions when crawling: Yes © No 
Crawl dynamic URLs (URLs containing '7'): C Yes No 


Allow URLs with multiple question marks? © Yes No 
URLs are case sensitive: © Yes No 


Maximum index depth (number of URL hops or ob Ae 
sub-directories from the starting point): o JEE 


Maximum depth of off-site URLs (number of hops bo qeda not alow ot ae lake 
away from defined web sites to crawl): 


Maximum file size to index (bytes): p 0 = unlimited 

Sync OAOA Maximum time to download a URL (seconds): [0 0—unlimited 
Delay between URL requests (milliseconds): p 0 = no delay 
Encoding (if not in META tags): | Western European (ISO-8859-1) 
Field names to display on Search Results pages: 





Any field names listed here can be included on the 
search results pages. To display the field on the search 


results pages, simply add a corresponding $$Variable 
to the desired template. Example: author date. created product dc. copyright 


E - 
» 

















3 Click Yes next to Obey Robots.txt exclusions when crawling to instruct QuickFinder to obey the 
instructions in the Robots.txt file as it indexes Web sites. 


For more information about Robots.txt, see “Using the Robots Meta Tag” on page 109. 


4 Click Yes next to Crawl dynamic URLs (URLs Containing *?”) if you want QuickFinder to index 
dynamic content, in addition to static content. 


Some search engines do not crawl Web pages that are created dynamically, such as pages 
generated from forms submitted by a Web browser. The URLs of dynamic content typically 
contain a question mark (?) followed by additional parameters. (See Section 8.7, “Indexing 
Dynamic Web Content,” on page 94.) 


Because dynamic content can change at any time, you might want to schedule more frequent 
regeneration events for your indexes when enabling this feature. For information about 
scheduling automatic updates to your indexes, see Section 8.9, “Automating Index and Server 
Maintenance,” on page 96. 


5 Click Yes next to Allow URLs with multiple question marks if you want QuickFinder to crawl URLs 
with multiple query strings (parameters). 


6 Select the URLs are case sensitive option if you want QuickFinder to recognize URLs that are 
different only in character case, but are otherwise identical. For example, 
www.digitalairlines.com versus www.DigitalAirlines.com. 





IMPORTANT: Setting this option to No can help QuickFinder avoid indexing duplicate 
information, which can come from indexing URLs that are presented in different cases but 
actually point to the same information. However, if a Web server being indexed is configured to 
differentiate between cases, QuickFinder might leave out content that you want indexed. 





7 In the Maximum index depth field, specify the maximum number of hypertext links from the 
starting URL that QuickFinder should follow before it stops indexing. 
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8 Inthe Maximum depth of off-site URLs field, specify the maximum number of hypertext links off- 
site from the starting URL that QuickFinder should follow before it stops indexing. 


9 Specify a number (in bytes) in the Maximum file size to index field to keep QuickFinder from 
indexing files larger than the number you specify. 


10 Inthe Maximum time to download a URL field, specify a number (in seconds) before QuickFinder 
automatically skips the indexing of the specified URL. 


11 Type a number (in milliseconds) in the Delay between URL requests field that QuickFinder should 
pause between requests for URLs that it is trying to index. 


12 From the Encoding (if not in META tags) drop-down list, select the encoding to be used when 
indexing files that do not contain an encoding specification. 


For example, HTML files can specify their encoding with a Content-Type meta tag. 


13 In the Field names to display on Search Results pages field, list any field names that you want to be 
included on the search results page (for example, author date created product dc.copyright). 


To display the field on the search results pages, add the corresponding $$Variable to the 
template (for example, $$author $$date_created $$product $$copyright). 


The field data is stored in the index and causes the index size to increase. 
14 Click Apply Settings. 


Allowing Indexes to Be Used with QuickFinder Synchronization 


1 On the QuickFinder Server Manager's Global Settings page, click Index under Default Settings. 
2 Under Synchronization Settings, click Yes next to Index may be copied to other clustered servers. 


For more information about QuickFinder Synchronization, see Chapter 9, “Synchronizing Data 
Across Multiple QuickFinder Servers,” on page 99. 


3 Click Apply Settings. 


Enabling or Disabling User Authentication When Accessing Indexes 


1 On the QuickFinder Server Manager's Global Settings page, click Index under Default Settings. 
2 (Optional) Under Rights-based Search Results, click Offto allow anyone to access the indexes. 
No user authentication is required to search the indexes of the current virtual search server. 


3 (Optional) Under Rights-based Search Results, click by Index to restrict access to the indexes only to 
those who have access rights to the filename you specify in the by Index field. 


4 In the by Index field, specify the full path to a file on your server that already has rights 
protection assigned to it. 


For example, if Apache 2 is your Web server, you might type /usr/local/Apache2/htdocs/ 
index.html. 


5 Select either Search Engine or Templates from the Unauthorized hits filtered by drop-down list to 
specify how QuickFinder should handle attempts to access indexes without authorization. 


¢ Select Engine if you don't want any search results displayed when users attempt to search 
the index without first logging in. A No Results Found message is returned instead. 


+ Select Templates to have QuickFinder return search results to users who have not logged in. 
When they attempt to click a search result, they are then prompted for a username and 
password. 
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TIP: You can use the $$BeginUnAuthorized and $$EndUnAuthorized template variables to 
control how the template should display unauthorized hits. For more information about 
template variables, see Chapter 12, “Working with Template Variables and Search Parameters,” 


on page 129. 





6 Click Apply Settings. 


7.2.5 Configuring Default Security Settings 


Security settings let you manage access to indexed content by requiring users to authenticate to a 
server before seeing rights-protected search results. The Security Settings page lets you configure 
rights-based search results and specify secure connection settings, including enabling the HTTPS 
protocol for securing usernames and passwords as they are sent over the network. 


€ “Modifying Default Rights-Based Search Results” on page 46 
+ “Modifying Default Connection Settings” on page 47 


Modifying Default Rights-Based Search Results 


1 On the QuickFinder Server Manager’s Global Settings page, click Security under Default Settings. 
2 Inthe Default search contexts field, type the eDirectory context where user objects are stored. 


If you provide a context here, users won't need to supply their fully qualified user IDs when 
logging in to QuickFinder. For example, if your user objects are all kept in a container named 
employees, type employees in the Default search contexts field so that QuickFinder knows where 
to look when a user attempts to log in. A user whose fully qualified name is 
sjones.employees.marketing.digitalairlines would only need to enter sjones. 


QuickFinder Server Manager - Mozilla Firefox 
File Edit View Go Bookmarks Tools Help 
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QuickFinder Server Manag 
Global Settings 


Virtual Search Servers Security Settings 


List This page lets you specify default security settings to be used when creating a new virtual search server. Existing virtual search 
Add servers are not affected. When you create a new virtual search server and make changes to its security settings, those changes 
— override these default settings. [ More About Global Security Settings] 


Default Settings Rights-based Search Results 


Default search contexts: 


QuickFinder Server will look in the specified contexts for users who do 
not provide a fully-qualified user ID. Contexts should be typeless and dot 
delimited. (example .marketing.novell.com) 


Check authorization by directory: 


If the search user has read rights to any file in a directory then the user 
will be allowed to see all search results from that directory. This method is 
faster than checking access rights for each file separately. 


Authentication realm string: QuickFinder Server 


This string is displayed on the browser's login dialog. If QuickFinder 
Server's realm and your web server's realm are the same, then users will 
only have to login once. 


Connection Settings 


Require https: Yes “No 
Auto-logout time (minutes): 30 I Disable auto-logout 


Apply Settings 


Synchronization 
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3 Click Yes next to Check authorization by directory if you want QuickFinder to validate user rights to 
files in a directory (search results) based on whether or not users have rights to any one file in 
the same directory. 


4 Inthe Authentication realm string field, specify the correct authentication realm string, which is 
typically shown in your Web browser's login dialog box. 


Specifying the Apache Web server's authentication realm string in this field means that after 
users authenticate to the Web server, they won't need to authenticate again when using 
QuickFinder to search and access protected information. 


If Apache is your Web server, refer to http://httpd.apache.org/docs-2.0/howto/auth.html (http:// 
httpd.apache.org/docs-2.0/howto/auth.html) for more information about authentication. 


5 Click Apply Settings. 


Modifying Default Connection Settings 


1 On the QuickFinder Server Manager's Global Settings page, click Security under Default Settings. 


2 Under Connection Settings, click Yes next to Require https if you want to protect usernames and 
passwords as they are sent across the network or Internet. 


3 Specify a number (in minutes) in the Auto-logout time field to direct QuickFinder to log users out 
who have been idle for the specified period of time. 


4 Click Apply Settings. 


Configuring Services Settings 


Services Settings lets you control all new and existing virtual search servers. For example, when you 
disable a feature such as e-mail services, the e-mail services feature is removed from the virtual 
search server configuration pages, making it impossible for the virtual search server administrator to 
access it. 


You can also perform other administrative tasks, such as checking for software updates and 
configuring QuickFinder synchronization. 


Services Settings are meant for global QuickFinder server administrators, giving them global control 
of the QuickFinder server and all virtual search servers, including the ability to completely disable a 
virtual search server. Services Settings also let the administrator control the overall performance of 
the QuickFinder server. 


Unlike the Default Settings, changes made here affect both new and existing virtual search servers. 
For example, if the e-mail feature is enabled from the Default General Settings page (accessed from 
the Global Settings page), and on the General Settings page of a virtual search server, the global 
administrator can disable it from General Services Settings. When that is done, the e-mail feature is 
disabled and its settings are removed from all other configuration pages. 

+ Section 7.3.1, “Configuring General Services Settings,” on page 48 

€ Section 7.3.2, “Configuring Search Services Settings,” on page 51 

è Section 7.3.3, “Configuring Print Services Settings,” on page 53 


+ Section 7.3.4, “Configuring Synchronization,” on page 55 
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7.3.1 Configuring General Services Settings 


General Services Settings let you configure product update, error log, and e-mail settings. If you 
disable a feature here, it is disabled on all virtual search servers and removed from their 
configuration pages. If you re-enable the feature, it reappears on all configuration pages with the 
same settings used before it was disabled by the global administrator. 


+ “Modifying Product Update Settings” on page 48 

€ “Modifying Administrator Authentication Settings” on page 49 
€ “Modifying Error Log Settings” on page 49 

e “Modifying E-Mail Settings” on page 49 

+ “Modifying Server Management Settings” on page 50 


Modifying Product Update Settings 


1 On the QuickFinder Server Manager's Global Settings page, click General under Services Settings. 


2 (Optional) Under Product Update Settings, click Yes next Check for product updates if you want 
QuickFinder to regularly check for software updates and notify you when updates are available. 
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List When you modify general service settings, you affect all virtual search servers on this server. This gives the QuickFinder Server 
Add administrator global control over all virtual search servers available from this server. [More About General Service Settings) 
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For more information, see Section 7.4, 'Updating QuickFinder Server Software,' on page 55. 
3 Click Apply Settings > Back to General Service Settings to save any changes you have made. 
Clicking Check Now causes any unsaved changes to be lost. 
4 To check for software updates immediately, click Check Now. 
5 Click Apply Settings. 


48 OES 11 SP2: Novell QuickFinder Server 5.0 Administration Guide 


Modifving Administrator Authentication Settings 


1 On the QuickFinder Server Manager's Global Settings page, click General under Services Settings. 
2 Under Administrator Authentication Settings, choose from the following options: 


¢ Require authorization when administering QuickFinder Server: Click Yes to require a 
login name and password when accessing QuickFinder Server Manager. 


+ Require HTTPS when administering QuickFinder Server: Click Yes to require the use of 
the secure HTTP protocol (HTTPS) when accessing QuickFinder Server Manager. 


3 Click Apply Settings. 


Modifying Error Log Settings 


1 On the QuickFinder Server Manager’s Global Settings page, click General under Services Settings. 


2 Under Error Log Settings, select where you want log results displayed by choosing one of the 
following options from the Log errors to drop-down list: 


¢ File: When this option is selected, you can click View next to the Log Errors To drop-down list 
to display the log results in your browser. 


+ Console: When this option is selected, the error log settings writes the logs to /var/opt/ 
novell/tomcat6-32bit/logs/catalina .out file. 


+ Both: Displays results in both your browser and at the system console. 
You can access the log file directly by going to /var/lib/qfsearch/Errors log. 


3 To start a new log file each time you restart the QuickFinder server, click Yes next to New log when 
services load. 


You can also delete the log file at the path specified above. The log file is re-created on the first 
instance of a new error, statistics, etc. 


4 To limit the size of the log file, specify a file size (in bytes) in the Maximum log size field. 


The number you specify here is divided evenly between two log files. For example, if you 
specify 30000, each log file allows up to 15000 bytes of logged data. This ensures that you always 
have at least 15000 bytes of logged synchronization data. 


5 Click Apply Settings. 


Modifying E-Mail Settings 


1 On the QuickFinder Server Manager's Global Settings page, click General under Services Settings. 


2 Under E-mail Settings, click Yes next to Enable e-mail services if you want QuickFinder to generate 
an e-mail message whenever errors occur during the generation (or regeneration) of your virtual 
search server's indexes, or when your indexes are being synchronized with other QuickFinder 
servers. 


3 Inthe Outgoing SMTP Host name field, specify the SMTP hostname of the mail server that 
handles e-mail requests (for example, mail.novell.com). 


4 In the Outgoing SMTP Port f field, specify the SMTP port number for the mail server specified 
above. 


Typically, the port number for mail servers is 25. 


5 (Optional) If your SMTP server requires authentication the, specify your user ID in the Outgoing 
SMTP User ID field. 
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6 (Optional) Specifv the matching password for vour SMTP user account in the Outgoing SMTP 
Password field. 


7 (Optional) Specifv an e-mail address in the From Address field. 
8 Click Apply Settings. 


Modifying Server Management Settings 


1 On the QuickFinder Server Manager's Global Settings page, click General under Services Settings. 


2 Under Server Management Settings, specify a number in the Maximum number of Active Index Jobs 
field to limit the number of indexing jobs that can run simultaneously. 


Any indexing jobs beyond the number you specify here are placed in a queue until one of the 
original indexing jobs is completed. 


Each server's performance varies because of hardware configuration and the amount of user 
traffic, so you should experiment with how many indexing jobs you can run simultaneously 
without negatively affecting the performance of your server. Also, you might consider using the 
Index Scheduling feature to regenerate indexes after business hours. See Section 8.9, “Automating 
Index and Server Maintenance,” on page 96 for more information. 


3 In the Default location of virtual search servers field, specify the path where you want all virtual 
search server files to be stored, including index and configuration files. 


Changing this setting won't move existing sites to the new default location, but all new virtual 
search servers are placed here. 


4 To direct QuickFinder to reload configuration files modified manually, outside of QuickFinder 
Server Manager, click Yes next to the Detect manual search server changes field. 


If you make changes outside of QuickFinder Server Manager, such as modifying configuration 
or properties files or any of the templates, QuickFinder re-reads those files as often as you 
indicate in the Seconds between checking for changes field. 


If you modify the adminservlet .properties file, you must reboot your server in order for the 
changes to take effect. This is the only file that cannot be re-read by using the Detect manual 
search server changes feature. 


5 In the Seconds between checking for changes field, specify how often QuickFinder should check for 
manual changes (changes made outside of QuickFinder Server Manager) to the configuration 
files. 


6 To direct QuickFinder to reload QuickFinder templates that have been modified, click Yes next to 
the Detect template changes field. 


After making a change to a template from within your HTML editing tool and saving it on your 
server, QuickFinder re-reads the template as often as you specify in the Seconds between template 
updates field. This means you can test your changes almost immediately. 


7 In the Seconds between checking for template changes field, specify how often QuickFinder should 
reload search, print, results, and error templates. 


8 Click Apply Settings. 
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7.3.2 


Configuring Search Services Settings 


Search Services Settings let you turn search capabilities on or off and manage debugging and 
statistics settings. 


e “Modifying General Search Services Settings” on page 51 
e “Modifying Search Debug Settings” on page 51 
+ “Modifying Search Statistics Settings” on page 52 


Modifying General Search Services Settings 


1 On the QuickFinder Server Manager's Global Settings page, click Search under Services Settings. 


2 Under General Search Settings, click Yes next to Enable search service to enable search services for all 
virtual search servers on your QuickFinder server. 
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Search Service Settings 


When you modify search service settings, you affect all virtual search servers on this server. This gives the QuickFinder Server 
administrator global control over all virtual search servers available from this server. [More About Search Service Settings] 


General Search Settings 


Enable search service: f'Ves FC No 


Enable highlighter service: @ Yes F No 


Debug Settings 


Enable search debugging: © Yes © No 

Log debug messages to: [Boh | ViewLog | 
New log when servlet loads: & Yes ©No 
Maximum log size (bytes): foooo 


Statistics Settings 


Enable search statistics logging: C Yes “No 

Seconds between statistics updates: bo 

Log statistics to: [Both | viewLog | 
Maximum log file size (bytes): 0000 

New log when servlet loads: @ Yes ©No 

Log error if search time exceeds (seconds): po 





3 To enable the highlighter, click Yes next to Enable highlighter service. 


4 Click Apply Settings. 


Modifying Search Debug Settings 





1 On the QuickFinder Server Manager’s Global Settings page, click Search under Services Settings. 


2 Under Debug Settings, click Yes next to Enable search debugging if you want to keep a log of all 
searches and query results going to all virtual search servers. 
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IMPORTANT: We recommend that vou use this feature onlv while setting up or 
troubleshooting your search services because the log file can grow in size very quickly. In 
addition, logging query and response details can slow down searches. 





Specify where you want log results displayed by selecting one of the following options from the 
Log debug messages to drop-down list: 


¢ File: When this option is selected, you can click View Log next to the Log debug messages To 
drop-down list to display the log results in your browser. 


+ Console: When this option is selected, the debug settings writes the logs to /var/opt/ 
novell/tomcat6-32bit/logs/catalina.out file. 


+ Both: Displays results in both your browser and at the system console. 


To start a new log file each time you restart the QuickFinder server, click Yes next to New log when 
servlet loads. 


To limit the size of the log file, specify a file size (in bytes) in the Maximum log size field. 


The number you specify here is divided evenly between two log files. For example, if you 
specify 30000, each log file allows up to 15000 bytes of logged data. This ensures that you always 
have at least 15000 bytes of logged synchronization data. 


Click Apply Settings. 


Modifying Search Statistics Settings 


1 
2 


On the QuickFinder Server Manager’s Global Settings page, click Search under Services Settings. 


Under Statistics Settings, click Yes next to Enable search statistics logging if you want an updated 
log file containing statistics about searches performed against all virtual search servers on your 
QuickFinder server. 


In the Seconds between statistics updates field, specify a number (in seconds) that should elapse 
between updates of the statistics log file. 


Specify where you want log results displayed by selecting one of the following options from the 
Log statistics to drop-down list: 


¢ File: When this option is selected, you can click View Log next to the Log statistics to drop- 
down list to display the log results in your browser. 


+ Console: When this option is selected, the statistics settings writes the logs to /var/opt/ 
novell/tomcat6-32bit/logs/catalina .out file. 


¢ Both: Displays results in both your browser and at the system console. 
To limit the size of the log file, specify a file size (in bytes) in the Maximum log file size field. 


The number you specify here is divided evenly between two log files. For example, if you 
specify 30000, each log file allows up to 15000 bytes of logged data. This ensures that you always 
have at least 15000 bytes of logged synchronization data. 


To start a new log file each time you restart the QuickFinder server, click Yes next to New log when 
servlet loads. 


In the Log error if search time exceeds field, specify a number (in seconds) before QuickFinder 
should record the current search as exceeding the specified time limit on the statistics display. 


This appears as the Limit portion of the statistics display. 
Click Apply Settings. 
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7.3.3 Configuring Print Services Settings 


+ “Modifying General Print Services Settings” on page 53 
+ “Modifying Print Debug Settings” on page 53 
e “Modifying Print Statistics Settings” on page 54 


Modifying General Print Services Settings 


1 On the QuickFinder Server Manager's Global Settings page, click Print under Services Settings. 


2 Under General Print Settings, click Yes next to Enable print service to enable print services for all 
virtual search servers on your QuickFinder Server. 
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3 Click Apply Settings. 


Modifying Print Debug Settings 


1 On the QuickFinder Server Manager’s Global Settings page, click Print under Services Settings. 


2 Under Debug Settings, click Yes next to Enable print debugging if you want print debugging turned 
on. 





IMPORTANT: We recommend that you use this feature only while setting up or 
troubleshooting your search services because the log file can grow in size very quickly. In 
addition, logging query and response details can slow down searches. 
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Specifv where vou want log results displaved bv selecting one of the following options from the 
Log debug messages to drop-down list: 


¢ File: When this option is selected, you can click View Log next to the Log debug messages to 
drop-down list to display the log results in your browser. 


+ Console: When this option is selected, the debug settings writes the logs to /var/opt/ 
novel1/tomcat6-32bit/logs/catalina.out file. 


+ Both: Displays results in both your browser and at the system console. 


To start a new log file each time you restart the QuickFinder server, click Yes next to New log when 
servlet loads. 


To limit the size of the log file, specify a file size (in bytes) in the Maximum log size field. 


The number you specify here is divided evenly between two log files. For example, if you 
specify 30000, each log file allows up to 15000 bytes of logged data. This ensures that you always 
have at least 15000 bytes of logged synchronization data. 


Click Apply Settings. 


Modifying Print Statistics Settings 


1 
2 


On the QuickFinder Server Manager’s Global Settings page, click Print under Services Settings. 


Under Statistics Settings, click Yes next to Enable print statistics logging if you want an updated log 
file containing statistics about print requests performed on your QuickFinder server. 


In the Seconds between statistics updates field, specify a number (in seconds) that should elapse 
between updates of the statistics log file. 


Specify where you want log results displayed by selecting one of the following options from the 
Log statistics to drop-down list: 


¢ File: When this option is selected, you can click View Log next to the Log statistics to drop- 
down list to display the log results in your browser. 


+ Console: When this option is selected, the statistics settings writes the logs to /var/opt/ 
novell/tomcat6-32bit/logs/catalina.out file. 


+ Both: Displays results in both your browser and at the system console. 
To limit the size of the log file, specify a file size (in bytes) in the Maximum log file size field. 


The number you specify here is divided evenly between two log files. For example, if you 
specify 30000, each log file allows up to 15000 bytes of logged data. This ensures that you always 
have at least 15000 bytes of logged synchronization data. 


To start a new log file each time you restart the QuickFinder server, click Yes next to New log when 
servlet loads. 


In the Log error if print time exceeds field, specify a number (in seconds) before QuickFinder 
should record the current print job as exceeding the specified time limit on the statistics display. 


This appears as the Limit portion of the statistics display. 
Click Apply Settings. 


54 OES 11 SP2: Novell QuickFinder Server 5.0 Administration Guide 


7.3.4 Configuring Synchronization 


QuickFinder Synchronization lets you designate one QuickFinder server as the search master from 
which updated indexes, templates, and configuration settings are systematically sent out to all other 
QuickFinder servers defined as part of a QuickFinder Synchronization cluster. 


For more information about setting up and configuring QuickFinder Synchronization, see 
“Synchronizing Data Across Multiple QuickFinder Servers” on page 99. 


7.4 Updating QuickFinder Server Software 


As new QuickFinder software becomes available, you can be notified automatically from within 
QuickFinder Server Manager. 


When new software is available, a message appears on the Global Settings page with a link indicating 
where you can download the latest version. 


1 On the QuickFinder Server Manager’s Global Settings page, click General under Services Settings. 
2 (Optional) Under Product Update Settings, click Yes next Check for product updates. 
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administrator global control over all virtual search servers available from this server. [More About General Service Settings] 


Product Update Settings 


Check for product updates: © Yes ©No Check Now 


Administrator Authentication Settings = 


Require authorization when administering QuickFinder A 
Server: FYes No 


Require HTTPS when administering QuickFinder Server: & Yes No 


Services Settings Error Log Settings 
General Log errors to: Both v| _ViewLog 


—— New log when services load: @ Yes f No 
— Maximum log size (bytes): foooo 


Svnchronization 
Enable e-mail services: f'Ves No 
Outgoing SMTP Host name: Jmailnovellcom SS 
Outgoing SMTP Port #: ps 
Outgoing SMTP User ID (optional): [etobiasson 
Outgoing SMTP Password (optional): fee 











3 Click Apply Settings > Back to General Service Settings to save any changes you have made. 
Clicking Check Now causes any unsaved changes to be lost. 

4 To check for software updates immediately, click Check Now. 

5 Click Apply Settings. 
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8.1 


Creating and Managing Virtual Search 
Servers 


This section provides detailed information about how to create and manage virtual search servers 
and their associated indexes bv using QuickFinder Server Manager. 


+ 


+ 


+ 


Section 8.1, “About Virtual Search Servers,” on page 57 

Section 8.2, “Creating Virtual Search Servers,” on page 58 

Section 8.3, “Enabling, Disabling, or Deleting a Virtual Search Server,” on page 60 
Section 8.4, “Configuring Virtual Search Servers,” on page 61 

Section 8.5, “Creating Indexes,” on page 79 

Section 8.6, “Managing Existing Index Files,” on page 92 

Section 8.7, “Indexing Dynamic Web Content,” on page 94 

Section 8.8, “Controlling Access to Search Results,” on page 95 

Section 8.9, “Automating Index and Server Maintenance,” on page 96 


Section 8.10, “Backing Up Your Virtual Search Server Files,” on page 97 


About Virtual Search Servers 


By definition, a virtual search server is a collection of one or more indexes and their related 
configuration files. Indexes and templates are at the heart of a virtual search server. An index is an 
optimized binary file that contains keywords found in documents hosted on a Web or file server. 
Indexes are used by QuickFinder to return search results to users’ Web browsers. Templates are 
HTML documents that contain dynamic content. The dynamic content is generated by the use of 
search parameters and variables inserted in various places in the templates. Templates are 
customizable and are used for several things, including displaying search and print results to users. 


For more information about templates, see Chapter 11, “Understanding Templates,” on page 123. 


Before creating virtual search servers, particularly large or mission-critical ones, you should carefully 


plan how to best set up QuickFinder to meet requirements of your search services. A search service 


used by a small-to-medium-sized department in a company requires different planning than a search 
service intended to serve thousands of customers on an enterprise-wide intranet Web site. 


For information about how to plan an effective search service, see Section 3.3, “Designing Your 
Search Solution,” on page 22. 
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8.2 Creating Virtual Search Servers 


After you have carefully planned your search service, you can start creating and configuring virtual 
search servers and begin adding indexes to them. 

+ Section 8.2.1, “Creating a Virtual Search Server,” on page 58 

+ Section 8.2.2, “Naming a Virtual Search Server,” on page 59 

+ Section 8.2.3, “Using the Virtual Search Server Alias,” on page 60 


+ Section 8.2.4, “Storing Virtual Search Server Files,” on page 60 


8.2.1 Creating a Virtual Search Server 
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1 On the QuickFinder Server Manager Global Settings page, click Add New Virtual Search Server. 


2 Inthe Name field, specify a new virtual search server name, which is typically the DNS or 
domain name of your server. 
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Enter a unique name for your new virtual search server. After creating your search server, you then need to 
define and generate one or more indexes. [More About Adding a New Virtual Search Server) 








Name: | * 
Use a domain name, such as www.novell.com. [More About Virtual Search Server Names 





Aliases: 


Services Settings 


General Enter the list of IP addresses, domain names, and other aliases that will be used to access this virtual 
search server. [More About Virtual Search Server Aliases] 





Search 


Print Location: 


Synchronization 
Location of all the virtual search server files. [More About Virtual Search Server Files] 
By default the virtual search server files will be located at /var/lib/qfsearch/Sites/{name}. 





Warning: the Virtual Search Server directory should not contain any other files. When a Virtual 
Search Server is deleted, all files within this directory and the directory itself are deleted 














For more information about virtual search server names, see “Naming a Virtual Search Server” 
on page 59. 


3 Inthe Aliases field, specify a virtual search server alias, which is typically the IP address of your 
server, the domain name, and any other alias that can be used to access this virtual search server. 


See “Using the Virtual Search Server Alias” on page 60 for more information about aliases. 


4 In the Location field, specify the path where you want the index and configuration files to be 
stored. 
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8.2.2 


If this field is left blank, QuickFinder stores the virtual search server files in the /searchroot/ 
sites/sitename directory. Also, you can store the files on any volume on the server where 
QuickFinder is installed, but not on other servers. 





NOTE: The wwwrun user must have read and write access to store the index and configuration 
files in the specified location. 





5 Click Add. 


Naming a Virtual Search Server 


When a user sends a search query to the QuickFinder Server, QuickFinder determines which of all of 
your virtual search servers it should use to handle the incoming search request. 


QuickFinder uses two methods for determining this: 


+ Matching the domain name of the search query with the virtual search server names available in 
QuickFinder 


+ Using the server=searchsitename query parameter to find matching virtual search server names 


For example, in the following search request, QuickFinder uses the domain name 
search. domainnamel.com as the name of the virtual search server: 


http: //search.domainnamel .com/qfsearch/SearchServlet?query=find+something 


This approach requires your server to be set up to recognize the domain name 
search. domainnamel.com. Most servers can be set up to recognize and service multiple domain 
names in both software and hardware virtual server configurations. 


You could also use an IP address to designate the virtual search server. For multiple virtual search 
servers, this approach works only in a hardware virtual server configuration where each virtual 
search server has its own unique IP address. 


Using One DNS Name to Host Multiple Virtual Search Servers 


If you are hosting a search service for two or more customers, you can name each virtual search 
server according to the organization or company name of each customer and then use the &server 
query parameter when handling search queries. One of the advantages of using the &server query 
parameter is that it allows you to use a single DNS name. 


For example, suppose your server's URL was searchit.novell.com. If you were setting up search 
services for a company called Digital Airlines and another company called DemoCity, you could host 
both services on your single server and then simply include the &server=digitalairlines and 
&server=democity query parameters within the search forms found on www.digitalairlines.com and 
www.democity.com. 


Queries would be sent from the search forms on each Web site to the URLs corresponding to each 
virtual search server, as in the following example: 


http://searchit .novell.com/qfsearch/SearchServlet ?server=digitalairlines 
and 


http: //searchit .novell.com/qfsearch/SearchServlet?server=democity 
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8.2.3 


8.2.4 


8.3 


8.3.1 


Using the Virtual Search Server Alias 


When defining a virtual search server, you are required to give ita name. However, you can also 
define an alias that can be used when identifying a specific virtual search server during a search 
request. 


An alias name typically follows one of two conventions: 
+ An IP address. 


This could be used either in the domain name portion of a URL or be included in a search querv 
using the &server query parameter. Using an IP address in place of a domain name to select a 
virtual search server works only in a hardware virtual server configuration where each search 
server has its own unique IP address. 

¢ Any other numeric or textual value that can be passed as the value of the &server query 
parameter. 


For most virtual search servers, the best choice for a search server name and alias is the Web server's 
domain name and IP address. 


Storing Virtual Search Server Files 


Search server files include a set of index and configuration files for each virtual search server. When 
you create a new virtual search server, you can specify where you want virtual search server files to 
be stored, or you can accept the default path, which is determined by where you installed the 
QuickFinder Server. 


Virtual search server files can be stored on any volume visible to the server that QuickFinder is 
installed on, regardless of which volume your QuickFinder Server is installed on. This includes SAN 
storage device volumes. 


Enabling, Disabling, or Deleting a Virtual Search Server 


You can disable a virtual search server or delete it from QuickFinder. When you disable a virtual 
search server, users receive an Unavailable Service message and cannot perform any searches. When 
you delete a virtual search server, all of its indexes and all related files are permanently deleted from 
your server. 

+ Section 8.3.1, “Enabling or Disabling a Virtual Search Server,” on page 60 


+ Section 8.3.2, “Deleting a Virtual Search Server,” on page 61 


Enabling or Disabling a Virtual Search Server 


1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to disable. 


2 Under Settings (in menu on the left), click On/Off. 


3 Click Turn ON or Turn OFF to enable or disable the current virtual search server. 
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When QuickFinder turns off the current virtual search server, the status above the Turn ON and 
Turn OFF buttons changes to OFF. 


8.3.2 Deleting a Virtual Search Server 


1 On the Global Settings page of QuickFinder Server Manager, click Delete in the row of the virtual 
search server that you want deleted. 


2 Click Delete Virtual Search Server to confirm the deletion. 
or 
Click Cancel Deletion to abort. 


WARNING: There is no way to restore a deleted virtual search server. Exercise caution before 
proceeding. 





8.4 Configuring Virtual Search Servers 


After you have created a virtual search server, you can fine-tune it by modifying many of its default 
settings. This section describes how to configure an individual virtual search server. 





TIP: When you create a new virtual search server, all of its default settings are inherited from the 
Global Settings pages of QuickFinder. If you are the global administrator, you can modify these 
settings so that when you create a new virtual search server, its default settings reflect your 
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preferences. (See Section 7.1, “Differences between Default and Services Settings,” on page 34.) 





+ Section 8.4.1, “Configuring General Settings,” on page 62 
+ Section 8.4.2, “Configuring Search Settings,” on page 67 
+ Section 8.4.3, “Configuring Print Settings,” on page 71 

+ Section 8.4.4, “Configuring Index Settings,” on page 73 

+ Section 8.4.5, “Configuring Security Settings,” on page 76 


+ Section 8.4.6, “Configuring Synchronization Settings,” on page 78 


8.4.1 Configuring General Settings 


The General Settings page of QuickFinder Server Manager lets you configure the way that the virtual 
search server handles requests from clients for search services. You can modify general search query, 
search response, error log, and e-mail settings (if the global administrator has enabled the e-mail 
feature). 

+ “Modifying General Search Query Settings” on page 62 

+ “Modifying Query Logging Settings” on page 64 

e “Modifying General Response Settings” on page 64 

+ “Modifying Error Log Settings” on page 65 

e “Modifying E-Mail Settings” on page 65 

¢ “Editing the Stop-Words List” on page 65 


Modifying General Search Query Settings 
1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to work with. 
2 Click General under Settings. 


3 From the Default query encoding drop-down list, select an encoding that represents the character 
set encoding that the users of your search services are most likely to use. 
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Active Jobs Query Settings 


Default query encoding: Unicode (UTF-8) sl 
Maximum querv duration (seconds): fo 


Enable stop-words processing: Yes C No. Editlist 


Enable svnonvm-enhanced search results: FYes C No. EditList 


Query Logging 


Synchronization Enable query logging: @ Yes No 
Exclude these IP addresses: 





A Example: <- exclude this specific IP 
Display Search Page 111.111.111.111 address 
Example: 111.111. <- exclude all IP addresses 
with this prefix 

Log period: Monthly sl 

E-mail log reports: C Yes “No 
Reports are automatically generated when a logging 
period ends. Select Yes and enter one or more 


recipients to e-mail the reports as they become 
available. 





If enabled, at least one e-mail recipient is required 


For more information about character sets, see Appendix B, “Combined Character Sets for Use 
with QuickFinder,” on page 193. 


In the Maximum query duration field, specify the maximum number of seconds before 
QuickFinder should end a query, regardless of whether a search has been completed. 


This option is one of several methods for letting you protect your server’s resources from 
processing potential rogue searches, which are sometimes intended to harm your service by 
consuming server resources. 


(Optional) Click Yes next to Enable stop-words processing if you want QuickFinder to ignore 
insignificant words, such as adverbs, conjunctions, or prepositions, in a user’s search query. 


For information about how to modify the list of stop-words used by QuickFinder, see “Editing 
the Stop-Words List” on page 65. 


(Optional) Click Yes next to Enable synonym enhanced search results if you want QuickFinder to 
expand search queries by looking for synonyms of the original search terms. 


Synonym enhancement is not performed within the FileFilter section of a search. For more 
information about synonym enhanced searches, see “Using Synonyms to Broaden Search 
Results” on page 114. 


Click Apply Settings. 
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Modifving Querv Logging Settings 


When querv logging is enabled, it captures manv details about user queries, including total number 
of searches performed (for the current logging period), top 100 search terms, load statistics, and the 
number of print jobs performed. It also provides information about queries that resulted in a 'not 
found” error message. This information can be used to improve the performance of your search 
services, or to identify areas of your site that could be improved. 


Query logging is enabled by default. However, itis optional and can be turned off. 
1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to work with. 
2 Click General under Settings. 
3 Click Yes next to Enable query logging. 
or 
If Query Logging has been enabled, click No to turn it off. 


4 In the Exclude these IP addresses field, specify one or more IP addresses of the computers that you 
want excluded from the query log, separating each additional address by a space or hard return. 


This feature enables you to eliminate query logging for searches originating within your 
organization. Keeping query log information gathered from customer queries separate from log 
information related to employees of your own company can help you identify issues that 
directly affect your customers. 


5 From the Log period drop-down list, select a log period of either Monthly or Weekly. 


QuickFinder records search requests in the current log file until the end of the specified period. 
When QuickFinder switches to a new log file, a report for the old log file is automatically 
generated. 


6 In the E-mail log reports field, specify one or more e-mail addresses where you want copies of 
each new log report sent, separating each additional address by a space or hard return. 


If this field does not appear, itis because you have disabled e-mail services on your QuickFinder 
Server. To re-enable e-mail services, go to the QuickFinder Global Settings page and click 
Services Settings > General > E-Mail Settings. 


7 To view an existing log report, select one from the Available log reports field, then click View 
Report. 


If there are no logs listed, you have not yet generated a log report. Click Generate Current to 
create a report of the current (not yet completed) log period. Depending on the amount of 
information in the logs, this process could take anywhere from a few seconds up to several 
hours to complete. After a new report is generated, it appears in this field. 


8 (Optional) If you want to specify a different logging template, specify the name of the template 
in the Template to use when generating reports field. 


9 Click Apply Settings. 


Modifying General Response Settings 
1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to work with. 
2 Click General under Settings. 


3 Under Response Settings, select an output encoding from the Default encoding for response pages 
drop-down list. 
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This setting specifies the encoding QuickFinder should use when responding to user queries 
using the search and print results templates, and the error and response messages templates. 


4 Specifv the maximum number of queries in the Refuse queries if potential hits exceed field to cancel 
the processing of search results that might take a long time to complete. 


5 Click Apply Settings. 


Modifving Error Log Settings 


1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to work with. 


2 Click General under Settings. 


3 In the Maximum log size field, specify the maximum size (in bytes) that QuickFinder should 
allow the log file to grow to. 


Depending on the number of visitors that your virtual search server hosts, log files can become 
large. This setting protects your svstem's hard drive resources. 


The number you specify here is divided evenly between two log files. For example, if you 
specify 30000, each log file allows up to 15000 bytes of logged data. This ensures that you always 
have at least 15000 bytes of logged synchronization data. 


4 Click Apply Settings. 


Modifying E-Mail Settings 


If this section of the General Settings page is not visible, it is because the global administrator has 
disabled it. If you are the global administrator, you can enable this feature from the Global Settings > 
Services Settings > General page. In the E-Mail Settings section, enable e-mail services, then specify an 
outgoing SMTP hostname, port number, user ID, and password. This makes the E-Mail Settings 
section appear on the General Settings page for a virtual search server. Follow the instructions below 
to enable or disable e-mail services and to specify recipients. 


1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to work with. 
2 Click General under Settings. 


(Optional) Click Yes next to Enable e-mail services if you want QuickFinder to generate an e-mail 
message when errors occur during the generation (or regeneration) of your virtual search 
server's indexes, or when your indexes are being synchronized with other QuickFinder servers. 
4 (Optional) If you enabled e-mail services, type one or more e-mail addresses indicating where 
error messages should be sent. 
If the global administrator has specified default e-mail recipients, they appear here. You can 
remove them, or simply add additional addresses. Separate addresses by using a space, comma, 
semicolon, or carriage return. 


5 Click Apply Settings. 


Editing the Stop-Words List 


Sometimes users include irrelevant words in their search strings, such as the conjunctions and, to, 
and of. These are referred to as stop words. The Stop Words feature of QuickFinder removes all 
occurrences of stop words from the search string before performing a search, except in the following 
situations: 


+ Stop words processing has been turned off. 
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+ You prepend the word with a plus (+) sign (for example, +the). 
¢ They are the only words in the query. 
¢ They occur within a phrase. 
You can add or remove words from the Stop-Words list. QuickFinder Server uses this list to 


determine which words it ignores in a user's search string. QuickFinder includes a predefined list of 
stop words, but you can edit or change these at any time. 


1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to work with. 

2 Click General under Settings. 

3 Click Apply Settings > Back to General Settings to save any changes you have made. 
Clicking Edit List causes any unsaved changes to be lost. 


4 Under Query Settings, click Edit List next to Enable stop-words processing. 
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anything 


5 (Optional) To add a new word to the Stop-Words list, type a new word directly into the list. 


Separate each new word with a space or a carriage return. When you click Apply, the word is 
added to the list in alphabetical order, regardless of where you entered it in the list. 


6 (Optional) To remove an existing stop word from the Stop-Words list, select it and press the 
Delete key. 


To removing a stop word from the Global Stop Words list, delete it from the global area. 
7 Click Apply. 


For information about enabling and editing the synonym enhanced search settings, see “Using 
Synonyms to Broaden Search Results” on page 114. 
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8.4.2 Configuring Search Settings 


The Search Settings page lets vou configure the wav that the virtual search server handles end user's 
search queries. You can modify search query, search response, and template settings. 


e “Modifying Search Query Settings” on page 67 


€ “Modifying Search Response Settings” on page 68 


+ “Modifying Template Settings” on page 69 


+ “Selecting Highlighter Colors” on page 70 


Modifying Search Query Settings 


1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 


virtual search server that you want to work with. 
2 Under Settings, click Search. 


3 Under Query Settings, click Edit next to Default indexes to search. 
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4 Select the indexes to be searched by default when a user does not select any indexes on the 


Search Settings 


This page lets you configure the way that this virtual search server should handle queries. Changes made here override the 
default configurations of Global Settings. [More About Search Settings] 


Query Settings 
Default indexes to search: Edit 


Enable search expansion: C Yes © No 


Default search expansion indexes: | Edit 


Enable search term redirection: Yes No EditList 


Enable Best Bets search results: € Ves © No 

Default Best Bets indexes to search: | _ Edit | 
Show Best Bets searches by default “Yes f No 

Maximum number of Best Bets results: B 

Minimum Best Bets relevance: fo 


Response Settings 


Default number of results to display: {25 
Maximum number of results per page: [200 
Highest allowed result number: fi 000 





search form when performing a search, then click Applv. 


5 (Optional) Click Yes next to Enable search expansion if you want QuickFinder to automatically 











perform a second search using additional indexes when a first search query fails to find results. 


For more information, see Section 10.6, “Helping Users Avoid Failed Searches,” on page 119. 


6 (Optional) If you enabled search expansion, click Edit next to the Default search expansion indexes 
field to select the indexes to be used during an expanded search, then click Apply. 
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7 (Optional) Click Yes next to Enable search term redirection if you want QuickFinder to redirect 
common search terms to a specific URL. 


For more information, see “Redirecting Searches” on page 117. 
8 Click Apply Settings > Back to Search Settings to save any changes you have made. 
Clicking Edit List causes any unsaved changes to be lost. 


9 (Optional) If you enabled search term redirection, click Edit List to add common terms and their 
associated URLs, then click Apply. 


For more information, see “Creating or Editing the Redirection URLs List” on page 117. 


10 (Optional) Click Yes next to Enable Best Bets search results if you want QuickFinder to insert a 
secondary results list at the top of the search results page. 


For more information, see “Using Best Bets to Help Users Find the Right Information” on 
page 113. 


11 (Optional) Click Edit next to the Default Best Bets indexes to search field and select the indexes for 
use with best bets. 


12 (Optional) If you want the best bets results to always appear on the search results page, select Yes 
next to Show Best Bets searches By default. 


Select No if you want users to request the best bets results list at the time of their search request. 


13 (Optional) In the Maximum number of Best Bets results field, type the maximum number of best 
bets results to be returned on each search results page. 


14 (Optional) In the Minimum Best Bets relevance field, type the number of low relevance documents 
you want removed from the best bets display list. 


15 Click Apply Settings. 


Modifying Search Response Settings 


1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to work with. 


2 Under Settings, click Search. 


3 Under Response Settings, specify the number of search results in the Default number of results to 
display field that you want displayed on each search results page. 


For example, if you set this option to 25 (which is the default setting) and the number of hits in a 
return was 200, QuickFinder only returns 25 hits per search results page at a time. 


4 Set a limit on the number of results allowed at one time on the results page by specifying a 
number in the Maximum number of results per page field. 


5 Specify the highest number of search results that can be returned to a user query in the Highest 
allowed result number field. 


6 (Optional) Click Yes next to Enable speller to have QuickFinder provide alternate spelling 
suggestions for search terms. 


7 Click Apply Settings > Back to Search Settings to save any changes you have made. 


Clicking Edit List causes any unsaved changes to be lost. 


00 


(Optional) Click Edit List to define your own words to ignore or misspelled words to replace. 
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9 (Optional) Use the Spell check if total hits is below option to have QuickFinder spell-check search 
terms if the number of search results is lower than the number specified. 


Settings 














10 (Optional) Click Yes next to Enable search terms Highlighter if you want users’ search terms to be 
highlighted in the documents returned in a search. 


11 Click Apply Settings > Back to Search Settings to save any changes you have made. 
Clicking Edit Colors causes any unsaved changes to be lost. 

12 Click Edit Colors to modify the colors used by the Highlighter. 
For information, see “Selecting Highlighter Colors” on page 70. 

13 Click Apply Settings. 


Modifying Template Settings 
1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to work with. 
2 Under Settings, click Search. 


3 Under Template Settings, specify a path to where your QuickFinder templates are stored in the 
Templates directory field. 


The default path is /var/lib/qfsearch/Templates. If you have created custom templates, or if 
you want to keep your templates elsewhere, specify the path here so that QuickFinder knows 
where the templates are. 


4 From the Default encoding for templates drop-down list, select the character set that your 
templates are written in. 


This value is used even with templates that do not specify an encoding. Encodings found in 
templates that do not match the encoding you specify here override this encoding. 
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5 Inthe Default search page template field, specifv the filename of the search page template vou want 
to use. 


If vou have created a custom template and want QuickFinder to use it as vour search page, 
specifv its name in this field. 


6 Inthe Default search results template field, specifv the filename of the search results template vou 
want to use. 


If vou have created a custom search results template and want QuickFinder to use it as vour 
default search results page, specifv its name in this field. 


7 Inthe Default highlighter template field, specifv the filename of the highlighter template vou want 
to use. 


If vou have created a custom highlighter template and want QuickFinder to use it as vour 
default search results page, specifv its name in this field. 


8 Inthe Template to use if no results returned field, specifv the filename of the template that 
QuickFinder should return if no results are found. 


9 Inthe Template to use if error occurs field, specify the filename of the template that QuickFinder 
should return if there are errors while processing a user's query. 


10 Click Apply Settings. 


Selecting Highlighter Colors 


Because a user can search for more than one search term at a time, you can define multiple colors so 
that each search term appears in a different color. For example, if a user searched for “HTTP AND 
Apache,” the terms appear highlighted in the documents where they originated. 


The colors are used in the order in which they are defined. If only two highlight colors are defined 
but a user searches for three search terms, the first color is repeated. 


1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to work with. 
2 Under Settings, click Search. 


3 On the Search Settings page, click Edit Colors under Response Settings. 
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The following list of colors is used during search term highlighting. The colors are used in the order in which they are defined 
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You can also specify the color value (such as #RRGGBB) or color names. 


5 To define additional color sets, click Add More Colors. 


6 To remove a defined color set, click Delete in the row of the color set you want removed. 


7 Click Apply. 


Configuring Print Settings 


The Print Settings page lets you configure the way that the current virtual search server handles end 


user’s print queries. You can modify print result and template settings. 


+ “Modifying Default Print Settings” on page 71 


€ “Modifying Default Print Template Settings” on page 72 


Modifying Default Print Settings 


1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 











virtual search server that you want to work with. 
2 Click Print under Settings. 


3 Under Print Results Settings, specify the number of print results in the Default number of results to 
print field that you want displayed on each print results page. 
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Indexing Print Settings 


Management ement This page lets you configure the way that this virtual search server should handle print requests. Changes made here override the 
Schedulin default configurations of Global Settings. [More About Print Settings] 
>cheduling 


Active Jobs Print Result Settings 


Default number of results to print: ps 
Settings Maximum number of results to print: [200 — 
Highest allowed result number: frooo 
Maximum print job size (bytes): [2097152 — 
Print job size warning (bytes): froz400 — 


Template Settings 
Synchronization Templates directory: Ivarlibiqfsearch/Templates 


Default encoding for templates: Unicode (UTF-8) sl 


Default print results template: [PrintresultTemplate.html 


Display Search Page 
Template to use if no results returned: |PrintResultNoHitsTemplate. html 


Template to use if more information needed: [ResponseMessageTemplate.html 
Template to use if error occurs: (ErrorMessageTemplate.htmi 


Applv Settings 








For example, if you set this to 25 (which is the default setting) and the number of hits in a return 
was 200, QuickFinder only returns 25 hits per print results page at a time. 


4 Set a limit on the number of results allowed at one time on the results page by specifying a 
number in the Maximum number of results to print field. 


5 Specify the highest number of search results that can be returned to a user query in the Highest 
allowed result number field. 


6 To limit the size of a printjob, specify the largest print job size that QuickFinder will allow in the 
Maximum print job size field. 


Users requesting a print job larger than this value receive a message informing them that the 
request was too large. 


This is a useful feature for administrators who want to keep down the size of print jobs in their 
own companies, departments, or organizations. 


7 To be notified when a print job exceeds a certain size, specify the printjob size in the Print job size 
warning field. 


By default, this message is sent by using the ResponseMessageTemplate.html file and is 
intended as a warning to users that they are exceeding the allowed print job size. It then prompts 
the user to confirm the print job before continuing. 


8 Click Apply Settings. 
Modifying Default Print Template Settings 


1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to work with. 


2 Click Print under Settings. 
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8.4.4 


3 Under Template Settings, specify a path in the Templates directory field to where your QuickFinder 
templates are stored. 


The default path is /var/lib/qfsearch/Templates. If you have created custom templates, or 
want to keep your templates elsewhere, specify the path here so that QuickFinder knows where 
the templates are. 


4 From the Default encoding for templates drop-down list, select the character set that your 
templates are written in. 


This value is used even with templates that do not specify an encoding. Encodings found in 
templates that do not match the encoding you specify here override this encoding. 


5 Inthe Default print results template field, specify the filename of the print results template you 
want to use. 


If you have created a custom print results template and want QuickFinder to use it when 
returning print results, specify its name in this field. 


6 Inthe Template to use if no results returned field, specify the filename of the template that 
QuickFinder should return if no print results match a user's query. 


7 In the Template to use if more information needed field, specify the filename of the template to be 
sent back to users whose print jobs exceed the size you specify in the Print Job Size field. (See 
Step 6.) 


8 Inthe Template to use if error occurs field, specify the filename of the template that QuickFinder 
should return if there are errors while processing a user's print query. 


9 Click Apply Settings. 


Configuring Index Settings 


These settings are intended to make the process of creating indexes even easier by letting you 
configure common settings as default settings. This saves you time by not making you make the same 
selections each time you create a new index. 

€ “Modifying Default Index Settings” on page 73 

+ “Allowing Indexes to Be Used With QuickFinder Synchronization” on page 75 

+ “Enabling or Disabling User Authentication When Accessing Indexes” on page 75 


Modifying Default Index Settings 


1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to work with. 


2 Click Index under Settings. 
3 Select the type of index that you want as the default index type on the Index Settings page. 
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Indexing Index Settings 
Management This page lets you specify default settings to be used when defining new indexes. Individual indexes can override these default 
Scheduling 
Shaws 
Index type: G Crawled © File system 
Settings Obey Robots.txt exclusions when crawling: @ Yes © No 
Crawl dynamic URLs (URLs containing '7'): C Yes No 


settings when editing them using the Advanced Index Definition pages. [More About Index Settings] 


Allow URLs with multiple question marks? © Yes No 
URLs are case sensitive: © Yes No 


Maximum index depth (number of URL hops or > ones 
sub-directories from the starting point): o a 


FAX Maximum depth of off-site URLs (number of hops p = cite li 
Synchronization away from defined web sites to crawl): P 0 = do not follow off-site links 


Maximum file size to index (bytes): 0 0 = unlimited 


Display Search Page Maximum time to download a URL (seconds): lo 0 = unlimited 
Delay between URL requests (milliseconds): jo 0 = no delay 


Encoding (if not in META tags): Western European (ISO-8859-1) vf 


Field names to display on Search Results pages: 





Any field names listed here can be included on the 
search results pages. To display the field on the search 
results pages, simply add a corresponding $$Variable 
to the desired template. 





Example: author date created product dc.copvright 
Example in template: $$author $$date_created $$ product $$: = 


I [>] 

















Each time you create a new index, the index type you select here is automatically selected. You 
can change the default index type when you create an index. 


4 Click Yes next to Obey Robots.txt exclusions when crawling to instruct QuickFinder to obey the 
instructions in the Robots.txt file as it indexes Web sites. 


For more information about Robots.txt, see “Using the Robots Meta Tag” on page 109. 


5 Click Yes next to Crawl dynamic URLs (URLs containing ‘?’) if you want QuickFinder to index 
dynamic content, in addition to static content. 


Some search engines do not crawl Web pages that are created dynamically, such as pages 
generated from forms submitted by a Web browser. The URLs of dynamic content typically 
contain a question mark (?) followed by additional parameters. (See Section 8.7, “Indexing 
Dynamic Web Content,” on page 94.) 


Because dynamic content can change at any time, you might want to schedule more frequent 
regeneration events for your indexes when enabling this feature. For information about 
scheduling automatic updates to your indexes, see Section 8.9, “Automating Index and Server 
Maintenance,” on page 96. 


6 Click Yes next to Allow URLs with multiple question marks if you want QuickFinder to crawl URLs 
with multiple query strings (parameters). 


7 Select the URLs are case sensitive option if you want QuickFinder to recognize URLs that are 
different only in character case, but are otherwise identical (for example, 
www.digitalairlines.com verses www.DigitalAirlines.com). 


IMPORTANT: Setting this option to No can help QuickFinder avoid indexing duplicate 
information, which can come from indexing URLs that are presented using different cases but 
actuallv point to the same information. However, if a Web server being indexed is configured to 
differentiate between cases, QuickFinder might leave out content that vou want indexed. 
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8 Inthe Maximum index depth field, specify the maximum number of hypertext links from the 
starting URL that QuickFinder should follow before it stops indexing. 


9 Inthe Maximum depth of off-site URLs field, specify the maximum number of hypertext links off- 
site from the starting URL that QuickFinder should follow before it stops indexing. 


10 Specify a number (in bytes) in the Maximum file size to index field to keep QuickFinder from 
indexing files larger than the number you specify. 


11 In the Maximum time to download a URL field, specify a number (in seconds) before QuickFinder 
automatically skips the indexing of the specified URL. 


12 Type a number (in milliseconds) in the Delay between URL requests field that QuickFinder should 
pause between requests for URLs that it is trying to index. 


13 From the Encoding (if not in META tags) drop-down list, select the encoding to be used when 
indexing files that do not contain an encoding specification. 


For example, HTML files can specify their encoding with a Content-Type meta tag. 


14 In the Field names to display on Search Results pages field, list any field names that you want to be 
included on the search results page (for example, author date created product dc.copyright). 


To display the field on the search results pages, add the corresponding $$Variable to the 
template (for example, $$author $$date_created $$product $$copyright). 


The field data is stored in the index and causes the index size to increase. 
15 Click Apply Settings. 


Allowing Indexes to Be Used With QuickFinder Synchronization 


1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to work with. 


2 Click Index under Settings. 
3 Under Synchronization Settings, click Yes next to Index may be copied to other clustered servers. 


For more information about QuickFinder Synchronization, see Chapter 9, “Synchronizing Data 
Across Multiple QuickFinder Servers,” on page 99. 


4 Click Apply Settings. 


Enabling or Disabling User Authentication When Accessing Indexes 


1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to work with. 


2 Click Index under Settings. 
3 (Optional) Under Rights-based Search Results, click Offto allow anyone to access the indexes. 
No user authentication is required to search the indexes of the current virtual search server. 


4 (Optional) Under Rights-based Search Results, click by Index to restrict access to the indexes only to 
those who have access rights to the filename you specify in the by Index field. 


5 In the by Index field, specify the full path to a file on your server that already has rights 
protection assigned to it. 


For example, if you are using Apache 2, you might type /usr/local/apache2/htdocs/ 
index.html. 


6 Select either Search Engine or Templates from the Unauthorized hits filtered by drop-down list to 
specify how QuickFinder should handle attempts to access indexes without authorization. 
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Select Search Engine if vou don't want anv search results displaved when users attempt to search 
the index without first logging in. A No Results Found message is returned instead. 


Select Template to have QuickFinder return search results to users who have not logged in. When 
they attempt to click a search result, they are then prompted for a username and password. 





TIP: You can use the $$BeginUnAuthorized and $$EndUnAuthorized template variables to 
control how the template should display unauthorized hits. For more information about 
template variables, see Chapter 12, “Working with Template Variables and Search Parameters,” 
on page 129. 





7 Click Apply Settings. 


8.4.5 Configuring Security Settings 


Security settings let you manage access to indexed content by requiring users to authenticate to a 
server before seeing rights-protected search results. The Security Settings page lets you configure 
rights-based search results and specify secure connection settings, including enabling the HTTPS 
protocol for securing usernames and passwords as they are sent over the network. 

e “Modifying Default Rights-Based Search Results” on page 76 


€ “Modifying Default Connection Settings” on page 77 


Modifying Default Rights-Based Search Results 


1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to work with. 


2 Under Settings, click Security. 


3 Inthe Default search contexts box, type the NetIQ eDirectory context where user objects are 
stored. 
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Indexing Security Settings 


Management This page lets you configure the way that this virtual search server should handle access to secure content. Changes made here 
Schedulin override the default configurations of Global Settings. [More About Security Settings] 
>cheduling 


Active Jobs Rights-based Search Results 


Default search contexts: 


Settings QuickFinder Server will look in the specified contexts for users who do 
not provide a fully-qualified user ID. Contexts should be typeless and dot 
delimited. (example .marketing.novell.com) 


Check authorization by directory: 


If the search user has read rights to any file in a directory then the user 
will be allowed to see all search results from that directory. This method is 
faster than checking access rights for each file separately. 


Authentication realm string: QuickFinder Server 


This string is displayed on the browser's login dialog. If QuickFinder 
Server's realm and your web server's realm are the same, then users will 
only have to login once. 


Connection Settings 


Require https: @Yes € No 
Auto-logout time (minutes): 30 I Disable auto-logout 


Applv Settings 


Svnchronization 





Displav Search Page 





If vou provide a context here, users won't need to supplv their fullv qualified user IDs when 
logging in to QuickFinder. For example, if vour user objects are all kept in a container named 
employees, type employees .marketing.digitalairlines in the Default Search Contexts box so 
that QuickFinder knows where to look when a user attempts to log in. A user whose fully 
qualified name is sjones.employees.marketing.digitalairlines only needs to enter sjones. 


4 Click Yes next to Check authorization by directory if you want QuickFinder to validate user rights to 
files in a directory (search results) based on whether or not users have rights to any one file in 
the same directory. 


If a larger number of results are from the same directory, this can help to speed up the search. 


5 (Optional) If you are using basic authentication (as apposed to using form-based 
authentication), then in the Authentication realm string field, specify the correct authentication 
realm string, which is typically shown in your Web browser's login dialog box. 


Specifying the Apache Web server's authentication realm string in this field means that after 
users authenticate to the Web server, they won't need to authenticate again when using 
QuickFinder to search and access protected information. 


If Apache is your Web server, refer to http://httpd.apache.org/docs-2.0/howto/auth.html (http:// 
httpd.apache.org/docs-2.0/howto/auth.html) for more information about authentication. 


6 Click Apply Settings. 


Modifying Default Connection Settings 


1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to work with. 


2 Under Settings, click Security. 


Creating and Managing Virtual Search Servers 77 


3 Under Connection Settings, click Yes next to Require https if you want to protect usernames and 
passwords as they are sent across the network or Internet. 


4 Specify a number (in minutes) in the Auto-logout time field to direct QuickFinder to log users out 
who have been idle for the specified period of time. 


5 Click Apply Settings. 


8.4.6 Configuring Synchronization Settings 


QuickFinder Synchronization lets you designate one QuickFinder server as the search master from 
which updated indexes, templates, and configuration settings are systematically sent out to all other 
QuickFinder servers defined as part of a QuickFinder Synchronization cluster. 


For more information about setting up and configuring QuickFinder Synchronization, see Chapter 9, 
“Synchronizing Data Across Multiple QuickFinder Servers,” on page 99. 


1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to work with. 
2 Under Settings, click Synchronization. 


3 Select Yes next to Let Virtual Search Server receive cluster data. 
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Indexing Synchronization Settings 





Management If you are running multiple installations of QuickFinder Server across several machines, you can simplify management tasks, such 
Schedulin as re-generating indexes, by synchronizing your QuickFinder Servers. By designating one of them as a search master, you can use 
>cheduling itto push new or updated indexes, virtual search server configuration settings, and new or updated templates to all other 
uickFinder Servers in your cluster. [More About Synchronization Settings] 
ctive Jobs kFinder S lust 


Receive Settings 


Settings Let Virtual Search Server receive cluster data: © Yes “ No 


Apply Settings 


Synchronization 





Display Search Page 





4 Click Apply Settings. 
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8.5 Creating Indexes 


QuickFinder creates two tvpes of indexes: 


+ Crawled: Created as QuickFinder follows (or crawls) hypertext links until it reaches a dead end. 
QuickFinder can crawl one or more Web sites, specific areas of a Web site, or specific URLs, even 
down to a specific filename. 


¢ File System: Created as QuickFinder index content on a file server. QuickFinder can index one 
or more paths on multiple volumes, including Storage Area Network (SAN) storage devices. 


There are two forms vou can use to create each tvpe of index: the standard form and the advanced 
form. The Define Crawled Index is the standard form for creating a crawled index, but the Define 
Crawled Index (Advanced) form offers more options than the standard form, including options that 
override default virtual search server settings. Both methods are described in the following sections. 

+ Section 8.5.1, “Creating a Crawled Index,” on page 79 

+ Section 8.5.2, “Creating an Advanced Crawled Index,” on page 80 

+ Section 8.5.3, “Configuring Rights-Based Search Results for Crawled Indexes,” on page 84 

¢ Section 8.5.4, “Creating a File System Index,” on page 85 

+ Section 8.5.5, “Creating an Advanced File System Index,” on page 86 

+ Section 8.5.6, “Configuring Rights-Based Search Results for File System Indexes,” on page 89 

+ Section 8.5.7, “Searching Across Multiple Indexes,” on page 89 

+ Section 8.5.8, “Indexing Content on a Password-Protected Web Site,” on page 90 

+ Section 8.5.9, “Indexing Volumes on Remote Servers,” on page 90 


+ Section 8.5.10, “Generating Indexes,” on page 90 


8.5.1 Creating a Crawled Index 


1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to work with. 


2 Under Define a New Index, click New crawled index, then click Define Index. 
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Indexing Index Management 


Management Once you have defined a virtual search server, you need to generate at least one index for the search server to become searchable 
Start either by defining a new index or by clicking one of the Action buttons for an existing index. [More About Managing Virtual Search Server 


Scheduling recae 
Active Jobs 

index tvpej Status [Action O 

Settings 0002 Crawled Not yetindexed Edit | Delete | Generate | View Log | 


Define a New Index 


G New crawled index 
C New file system index 


Define Index 





Synchronization 





Display Search Page 





3 In the Index Name field, specify a name for your index. 


A name can be a word, phrase, or a numeric value. If the virtual search server you are working 
on contains, or will contain, a large number of indexes, you might want to use a numbering 
scheme to help you manage multiple indexes more effectively. However, the name you specify 
here appears on the default search page, so you might want to choose a name that can be 
understood by users of your search services. 


4 Under Web Sites to Crawl, specify the URL of the Web site that you want indexed. 


You can specify just the URL, such as www.mycompany.com, or you can also append a complete 
path, down to the file level, such as www.mycompany.com/path/index.html. 


5 If desired, add another URL. To add additional URLs, click.Add More URLs 
6 Click Apply Settings. 


8.5.2 Creating an Advanced Crawled Index 


The Define Crawled Index (Advanced) page offers some additional options beyond those available in 
the standard Define Crawled Index page. Changes made using this page override default virtual 
search server settings. 


1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to work with. 

2 Under Define a New Index, click New crawled index, then click Define Index. 

3 On the Define Crawled Index page, click Advanced Index Definition. 


4 In the Index Name field, specify a name for your new index. 
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Indexing Define Crawled Index (Advanced) 


Management This page offers the advantage of overriding default index settings for the new index you are about to create. [More About Definit 
Scheduli Crawled Index (Advanced)' 
sian! required = * 


Active Jobs 
Index Name: a E 
Settings Index description: [O 


Web Sites to Crawl 


Enter one or more Web Sites to crawl. Only links within the given Web Sites will be followed and indexed 


URL of Web Site:* Path Weight: /100 Remove Web Site 
F' Use only as a craw filter? 


: a Note: ifchecked, QuickFinder Server 
Show URL in search results as: will not use this URL to begin 


RAR indexing. However, any subsequent 
Synchronization links will be allowed if they match this 


URL. 





Diealmvisaaraħ Pana Subdirectories to exclude: i 
isplay Search Fage Extensions to € include or 


C exdude: 


Example: htm txt pdf 
Example: /marketing or /sales/docs 


Define More Web Sites ... 

















A name can be a word, phrase, or a numeric value. If the virtual search server vou are working 
on contains, or will contain, a large number of indexes, vou might want to use a numbering 
scheme to help you manage multiple indexes more effectivelv. However, the name you specify 
here appears on the default search page, so you might want to choose a name that can be 
understood by users of your search services. 


5 In the Index description field, specify an optional description of the index to be created. 
6 Under Web Sites to Crawl, specify the URL of the Web site to be indexed. 


10 


If you specify a filename at the end of the URL, just that file is indexed. 
(Optional) Use the Path Weight option to boost or degrade search results based on the path. 


A weight of 100 makes the path's relevance normal. Increasing the weight makes the path more 
relevant, and lowering the weight makes the path less relevant. 


(Optional) Select Use only as a crawl filter if you don't want QuickFinder to use the URL you 
specified in the URL of Web Site field to begin indexing. 


Any subsequent links found that contain a URL matching the one you specified in the URL of 
Web Site field are followed and subsequently indexed. 


(Optional) If you want to mask the actual URL displayed in the search results template, specify 
an alternate URL in the Show URL in search results as field. 


For example, if you want to index a Web server that is used inside of your company but only 
allow your customers access to some of the data, you could hide the actual internal URL with the 
URL of your public Web site. 


In the Subdirectories to exclude text box, specify the directories that you want QuickFinder not to 
index. 


For example, /marketing or /sales/doc. 
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14 
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To direct QuickFinder to include or exclude specific file tvpes, click Extensions to include or 
Extensions to exclude and then specify the extensions, such as HTM PDF TXT, separating each one 
with a single space. 


To add additional URLs, click Define More Web Sites. 
To delete a URL, select it and click Remove Web Site. 


In the Additional URLs text box, specify any other URLs that you want indexed (for example, 
www.mycompany.com/marketing). 


This allows you to specify additional areas of information found on other Web sites, but not 
include all of the content of those sites to your searches. 


When QuickFinder encounters links found in the pages of Additional URLs that point to pages 
specified in Web Sites to Crawl, QuickFinder follows those links. All other links that go outside of 
Web Sites to Crawl are not followed. 


Use the Off-Site URLs option to determine the maximum number of off-site URLs (those URLs 
not located within any of the URLs specified in Web Sites to Crawl) that QuickFinder should 
index. 


In the URLs to Exclude field, list the off-site URLs that you want to exclude from indexing. 


Use the Adjust Individual URL Relevance option to adjust the relevance of individual items within 
the index. 


Adjustment values can range from 1 to 200. Values higher than 100 increase the calculated 
relevance of the item on the search results page, and values lower than 100 decrease the 
calculated relevance of the item. The value specified here is combined with other values to 
determine the final relevance. 


Under Additional Settings, specify the absolute path to where you want the index files stored in 
the Location of Index Files field. 


For example, /var/lib/qfsearch/sites/mysites. 


By default, index files are stored at /var/lib/qfsearch/Sites/default/indexes/ 
index name. 


Changes made to Additional Settings override Default Settings. 





NOTE: The wwwrun user must have read and write access to store the index files in the 
specified location. 





From the Level of detail in indexing logs drop-down list, select the amount of information vou want 
included in the index logs. 


Option Description 

Disabled Turns off index logging. 

Terse Lists only the URLs indexed. 

Normal Lists the URLs indexed and the results of the crawl. 

Verbose Lists the URLs indexed, the results of the crawl, and the links that were 


skipped during the crawl. 


New Links Lists the URLs indexed, the results of the crawl, the links that were skipped, 
and any new links found during the crawl. 


All Links Lists the URLs indexed, the results of the indexing, the links that were 
skipped, and all links found during the crawl. 
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From the Encoding (if not in META tags) drop-down list, select the encoding to be used by files 
being indexed that do not contain an encoding specification. 


In the Field names to display on Search Results pages field, list any field names that you want to be 
included on the search results page (for example, author date_created product dc.copyright). 


To display the field on the search results pages, add the corresponding $$Variable to the 
template (for example, $$author $$date_created $$product $$copyright). 


Use the Index Weight option to boost or degrade search results based on the item's index. 


A weight of 100 makes the item's relevance normal. Increasing the weight makes the item more 
relevant, and lowering the weight makes the item less relevant. 


In the Maximum index depth field, specify the number of jumps (or links) from the starting URL 
that QuickFinder should crawl. 


In the Maximum file size to index field, specify the maximum file size (in bytes) that QuickFinder 
should index. 


Files exceeding this size are not indexed and are not included in search results. 


In the Maximum time to download a URL field, specify a number (in seconds) before QuickFinder 
automatically skips the indexing of the specified URL. 


In the Delay between URL requests field, specify the amount of time (in milliseconds) QuickFinder 
should delay before attempting to index a URL. 


To direct QuickFinder to pay attention to the case of filenames and directory names, click Yes 
next to URLs are case sensitive. 


To direct QuickFinder to crawl dynamic content (URLs containing the question mark [?]), click 
Yes next to Crawl dynamic URLs. 


For more information about indexing dynamic content, see Section 8.7, “Indexing Dynamic Web 
Content,” on page 94. 


Click Yes next to Obey Robots.txt exclusions when crawling if you want QuickFinder to following 
instructions found in any Robots meta tags. 


For more information, see “Using the Robots Meta Tag” on page 109. 


Click Yes next to Index may be copied to other clustered servers if you want to allow this index to be 
copied to other servers in a QuickFinder Synchronization cluster. 


For more information about QuickFinder Synchronization, see Chapter 9, “Synchronizing Data 
Across Multiple QuickFinder Servers,” on page 99. 


Click Yes to activate the newly generated index irrespective of the size. 


The default option is No for the Always activate new index option. Ifit is set to No, then the newly 
generated index is compared with the current one. If the size of the new index is small when 
compared to the existing one, an error message is displayed in the Admin console. 


If the URLs to be crawled require authentication, use the Type of Authentication required to crawl 
web site option to select the methods for providing the correct user credentials. 


¢ Basic: If you know that the server to be indexed requires basic authentication, select Basic, 
then specify the username and password in the Crawler Credentials fields. 


For example, if you are indexing www.company1.com and it uses basic authentication, 
specify the username (user ID) and password in the Crawler Credentials fields. In this case, 
the credentials are sent using an HTTP authorization header with every request made to the 
server of the URL you have specified. 


+ Form: If the server to be indexed uses form-based authentication, type the correct user 
credentials in the Form Fields box. For example: UserIDField:$$UserID 
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In form-based authentication, the first time the Web site is indexed, the credentials are sent 
and a session cookie is returned. Thereafter, QuickFinder uses the session ID in the cookie 
for authentication and the credentials are no longer sent to the Web site. 


If vou are indexing more than one URL and each one requires a different set of credentials, 
we recommend that vou create a separate index for each URL. 


Bv default, QuickFinder Server sends the form-based credentials bv using the HTTP Post 
protocol. If the Web sites being indexed require the HTTP Get protocol, deselect the Send 
login data using HTTP post protocol check box. When this option is not selected, QuickFinder 
Server sends the form-based credentials as query parameters to the URLs being indexed. 


32 (Optional) If the Web sites you are indexing require users to log in at a specific URL (such as 
login.digitalairlines.com), specify the login URLs in the Alternate Login URLs field. 


After the session cookies are returned, QuickFinder sends the appropriate cookies as needed to 
the Web sites being indexed. 


33 Select Yes next to Use Crawler Credentials when Highlighting to use the Crawler Credentials specified 
Step 31 instead of the search user's credentials when requesting the specified documents. 


34 In the HTTP Headers field, specify any additional headers and values you want included with 
each HTTP request, placing each header on a separate line. 


Some Web sites require specific information in HTTP headers when attempts are made to access 
them. If your Web site uses form-based or cookie-based authentication, you can specify the 
information here. 


35 Click Apply Settings. 


After you define an index, you must generate it to make it searchable. See “Generating Indexes” on 
page 90. 


8.5.3 Configuring Rights-Based Search Results for Crawled Indexes 
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1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to work with. 


2 Under Define a New Index, select New crawled index, then click Define Index. 
3 On the Define Crawled Index page, click Advanced Index Definition. 


4 Under Rights-based Search Results, configure authorization checking by selecting one of the 
following options: 


+ Use Default: Select this option if you want this index to use the default authorization 
checking setting specified on the Index Settings page of your virtual search server. 


¢ Off: If you want all users to have access to this index, select this option. No authorization 
checking is done. 


¢ by Index: To enable rights checking for this index, specify a file that exists on your server 
that can be used in verifying user access. By creating a file and setting access rights to it, 
QuickFinder can verify access to this index based on the rights to the file. Click Use default 
path if a path was specified on the Index Settings page. 





NOTE: NCP (eDirectory) rights-based search results option that is supported for remote 
NCP volumes is not applicable for crawled indexes. In case of NCP-based remote volume 
indexes, it is possible to restrict search results based on logged in user's rights to individual 
files and directories. 
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5 From the Unauthorized hits filtered by drop-down list, select one of the following filters: 


+ Use Default: Select this option if you want the current index to use the default setting 
found on the Index Settings page. 


¢ Search Engine: When you select this option, users attempting to search the index without 
logging in do not see any of the unauthorized hits on the search results page. If the user 
doesn't have access to any search results, then the system returns a No Results Found 
message on the search results page. 


+ Templates: When you select this option, users attempting to search the index without 
logging in to the system receive results, but they are then required to provide a username 
and password before being allowed to see the contents. 


6 Click Apply Settings. 


After you define an index, you must generate it to make it searchable. See “Generating Indexes” on 
page 90. 


8.5.4 Creating a File System Index 


1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that you want to work with. 


2 Under Define a New Index, click New file system index, then click Define Index. 
3 In the Index Name field, specify a name for your index. 


A name can be a word, phrase, or a numeric value. If the virtual search server you are working 
on contains, or will contain, a large number of indexes, you might want to use a numbering 
scheme to help you manage multiple indexes more effectively. However, the name you specify 
here appears on the default search page, so you might want to choose a name that can be 
understood by users of your search services. 


4 In the Server Connection field, select Yes if the files to be indexed are on an NCP server, then 
specify the NCP server name, a valid username, password, and the character set of the server. 





NOTE: You must specify the username in the user.ou.o format. 





The user must have at least read rights to all the files. If you want to do rights-based searches, 
the user must have administrator rights to the NCP server. 


The Server Charset option must be set correctly so that the URLs can be properly encoded 
(according to the server encoding). 


This option is useful if you have a local NSS volume on the same machine as your QuickFinder 
index and you want to create a rights-based search for your users, or if you have a local or 
remote NCP server (such as a NetWare server, another server with NCP on it, or a local indexing 
machine) and you want to centralize your indexing. 


If you choose this option, make sure that the Corresponding URL Prefix option in the Path 
Information section contains a complete URL so that your users can access the indexed files from 
the NCP server. Also, if you are planning on indexing a large number of files (for example, over 
a million), your system should have at least 2 GB of memory. 


5 In the Server path to be indexed field, specify the absolute path to the folder containing the 
information that you want indexed (for example, /var/lib/qfsearch/data). 


6 Inthe Corresponding URL prefix field, specify the URL that should be used by the search results 
page to access the individual files (for example, /sales). 


You can also specify a file URL containing the UNC path of the server and path. The syntax is 
file://///server-dns-name/volume/path. 
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If the filename contains non-ASCII characters, set the return encoding of the Search Result page 
to match the encoding of the client's machine. You can set the return encoding on the General 
Settings page, or the client can set it by specifying the value of the encoding being sent to the 
search server in the retencoding search parameter. For example, the default English Windows 
encoding is Windows-1252, and Japanese is Shift-Jis. In order for the page to open, the client 
must already be authenticated to the server that the path points to. 


7 To add additional paths, click Add More Paths. 
8 Click Apply Settings. 


After you define an index, you must generate it to make it searchable. See “Generating Indexes” on 
page 90. 


8.5.5 Creating an Advanced File System Index 


1 On the QuickFinder Server Manager Global Settings page, click Manage in the row of the virtual 
search server that you want to work with. 


2 Under Define a New Index, click New file system index, then click Define Index. 
3 On the Define File System Index page, click Advanced Index Definition. 


4 In the Index Name field, specify a name for your new index. 


QuickFinder Server Manager - Mozilla Firefox 
File Edit View Go Bookmarks Tools Help 
SUSE Linux + Entertainment» News Internet Search + Reference» Mapsand Directions» Shopping + People and Companies + 
QuickFinder Server Manag 


www.brainshare/com 


Indexing Define File System Index (Advanced) 


Management This page offers the advantage of overriding default settings for the new index you are about to create. [More About Defining File System 
3 Index (Advanced) 

Scheduling 

Active Jobs 


. * 
Settings Index Nans ] 
Index description: 


Server Connection 


required = * 


Is NCP Server Index: + Yes E No. Note: If yes, all paths entered below must be NCP Server (More About NCP Server 
paths. Indexes] 


Exampé: data/sales/reports 


Synchronization Path Information 


Server path:* Path Weight: [100 Remove Path 
Display Search Page 


Corresponding URL prefix:* 





Subdirectories to exclude: 


Extensions to € include or 
© exclude: 


Example: htm txt pdf 




















A name can be a word, phrase, or a numeric value. If the virtual search server you are working 
on contains, or will contain, a large number of indexes, you might want to use a numbering 
scheme to help you manage multiple indexes more effectively. However, the name you specify 
here appears on the default search page, so you might want to choose a name that can be 
understood by users of your search services. 


5 Inthe Index description field, specify an optional description of the index to be created. 
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In the Server Connection field, select Ves if the files to be indexed are on an NCP server, then 
specifv the NCP server name, a valid username, password, and the character set of the server. 


The user must have at least read rights to all the files. If vou want to do rights-based searches, 
the user must have administrator rights to the NCP server. 


The Server Charset option must be set correctly so that the URLs can be properly encoded 
(according to the server encoding). 


This option is useful if vou have a local NSS volume on the same machine as vour QuickFinder 
index and vou want to create a rights-based search for vour users, or if vou have a local or 
remote NCP server (such as a NetWare server, another server with NCP on it, or a local indexing 
machine) and vou want to centralize vour indexing. 


If vou choose this option, make sure that the Corresponding URL Prefix option in the Path 
Information section contains a complete URL so that vour users can access the indexed files from 
the NCP server. Also, if vou are planning on indexing a large number of files (for example, over 
a million), vour svstem should have at least 2 GB of memorv. 


Under Path Information, specifv the absolute path to the folder containing the information that 
you want indexed in the Server path field (for example, /var/lib/qfsearch/data). 


(Optional) Use the Path Weight option to boost or degrade search results based on the path. 


A weight of 100 makes the path's relevance normal. Increasing the weight makes the path more 
relevant, while lowering the weight makes the path less relevant. 


In the Corresponding URL prefix field, specify the URL that should be used by the search results 
page to access the individual files (for example, /sales). 


You can also specify a file URL containing the UNC path of the server and path. The syntax is 
file://///server-dns-name/volume/path. 


If the filename contains non-ASCII characters, set the return encoding of the Search Result page 
to match the encoding of the client’s machine. You can set the return encoding on the General 
Settings page, or the client can set it by specifying the value of the encoding being sent to the 
search server in the retencoding search parameter. For example, the default English Windows 
encoding is Windows-1252, and Japanese is Shift-Jis. In order for the page to open, the client 
must already be authenticated to the server that the path points to. 


To exclude specific subdirectories from being indexed, specify their relative paths in the 
Subdirectories to exclude field. 


To direct QuickFinder to include or exclude specific file types, click Extensions to include or 
Extensions to exclude and then type the extensions, separating each one with a single space, such 
as HTM PDF TXT. 


(Optional) To add additional paths, click Define More Paths. 
(Optional) To delete a path, select it and click Remove Path. 


Use the Adjust Individual File Relevance option to adjust the relevance of individual items within 
the index. 


Adjustment values can range from 1 to 200. Values higher than 100 increase the calculated 
relevance of the item on the search results page, and values lower than 100 decrease the 
calculated relevance of the item. The value specified here is combined with other values to 
determine the final relevance. 


In the Location of index files field, specify the absolute path to where you want the index files 
stored. 


For example, /var/lib/qfsearch/sites/mysites. 


By default, index files are stored at /var/lib/qfsearch/Sites/default/indexes/ 
index name. 
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NOTE: The wwwrun user must have read and write access to store the index files in the 
specified location. 





From the Level of detail in indexing logs drop-down list, select the amount of information vou want 
included in the index logs. 


Option Description 

Disabled Turns off index logging. 

Terse Lists only the files indexed. 

Normal Lists the files indexed and the results of the crawl. 

Verbose Lists the files indexed, the results of the crawl, and the links that were skipped 


during the crawl. 


New Links Lists the files indexed, the results of the crawl, the links that were skipped, and 
any new links found during the crawl. 


All Links Lists the files indexed, the results of the indexing, the links that were skipped, 
and all links found during the crawl. 


From the Encoding (if not in META tags) drop-down list, select the encoding to be used when 
indexing files that do not contain an encoding specification. 


For example, HTML files can specify their encoding with a Content-Type meta tag. 


In the Field names to display on Search Results pages field, list any field names that you want to be 
included on the search results page (for example, author date created product dc.copyright). 


To display the field on the search results pages, add the corresponding $$Variable to the 
template (for example, $$author $$date_created $$product $$copyright). 


The field data is stored in the index and causes the index size to increase. 
Use the Index Weight option to boost or degrade search results based on the item's index. 


A weight of 100 makes the item's relevance normal. Increasing the weight makes the item more 
relevant, and lowering the weight makes the item less relevant. 


In the Maximum index depth field, specify the number of directories from the starting directory 
QuickFinder should search. 


This lets you limit how far (or deep) into a file server QuickFinder should search. 


In the Maximum file size to index field, specify the maximum file size (in bytes) that QuickFinder 
should index. 


Files exceeding this size are not indexed and are not included in search results. 


(Optional) Click Yes next to Index may be copied to other clustered servers if you want this index 
shared with other QuickFinder servers in a QuickFinder Synchronization cluster. 


For more information about QuickFinder Synchronization, see Chapter 9, “Synchronizing Data 
Across Multiple QuickFinder Servers,” on page 99. 


Click Yes to activate the newly generated index irrespective of the size. 


The default option is No for the Always activate new index option. Ifit is set to No, then the newly 
generated index is compared with the current one. If the size of the new index is small when 
compared to the existing one, an error message is displayed in the Admin console. 


Click Apply Settings. 
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After you define an index, you must generate it to make it searchable. See “Generating Indexes” on 
page 90. 


8.5.6 Configuring Rights-Based Search Results for File System Indexes 


1 On the QuickFinder Server Manager Global Settings page, click Manage in the row of the virtual 
search server that you want to work with. 


2 Under Define a New Index, select New file system index, then click Define Index. 
3 On the Define File System Index page, click Advanced Index Definition. 


4 Under Rights-based Search Results, configure authorization checking by selecting from one of the 
following options: 


+ Use Default: Select this option if you want this index to use the default authorization 
checking setting specified on the Index Settings page of your virtual search server. 


¢ Off: If you want all users to have access to this index, select this option. No authorization 
checking is done. 


+ by Index: To enable rights checking for this index, specify a file that exists on your server 
that can be used in verifying user access. By creating a file and setting access rights to it, 
QuickFinder can verify access to this index based on the rights to the file. Click Use Default 
Path if one was specified on the Index Settings page. 


+ by Result Item: If checked, QuickFinder verifies the user's access rights to each hit. This is 
not recommended for high-traffic servers because checking every hit can slow down server 
performance. 





NOTE: Rights-based search results with Result Item works fine only if the NCP volume 
present on local or remote machine is indexed using NCP channel. To make 
NCP(eDirectoty) rights-based results option to work, you must set Is NCP Server index to 


yes. 





5 From the Unauthorized hits filtered by drop-down list, select one of the following filters: 


+ Use Default: Select this option if you want the current index to use the default setting 
found on the Index Settings page. 


¢ Search Engine: When you select this option, users attempting to search the index without 
logging in do not see any of the unauthorized hits on the search results page. If the user 
doesn't have access to any search results, then the system returns a No Results Found 
message on the search results page. 


+ Templates: When you select this option, users attempting to search the index without 
logging in to the system receive results, but they are then required to provide a username 
and password before being allowed to see the contents. 


6 Click Apply Settings. 


After you define an index, you must generate it to make it searchable. See “Generating Indexes” on 
page 90. 


8.5.7 Searching Across Multiple Indexes 


QuickFinder can search across multiple indexes within a single virtual search server. However, 
searching a single index is generally faster than searching across multiple indexes. 
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8.5.8 


8.5.9 


8.5.10 


Restricting Search Results to Specific Areas 


You can restrict search results to specific areas of your file or Web server in the following ways: 


¢ Using multiple indexes and using the &index=index_name query parameter. 


¢ Using a single index and restricting results to certain URL paths by using the &filefilter=path 
query parameter. 


¢ Using a single index and restricting results to certain values in document fields by including 
Mieldname=value with either the query=value or filter=value search parameters. 





TIP: Using the last option requires that indexed documents contain summary fields such as meta 
tags. This option works for almost any file format that contains document summary fields, including 
HTML, XML, PDF, Word, and WordPerfect. 





For information about preventing QuickFinder from indexing specific content, see “Excluding 
Documents from Being Indexed” on page 109. 


Indexing Content on a Password-Protected Web Site 


If the Web servers you want to index require authentication, there are two methods for providing the 
correct user credentials: basic authentication and form-based authentication. Which one you choose 
depends on how authentication is implemented on the Web sites you index. For example, if you are 
indexing www.company1.com and it uses basic authentication, specify the username (user ID) and 
password in the Crawler Credentials fields. In this case, the credentials are sent using an HTTP 
authorization header with every request made to the server of the URL you have specified. 


However, if www.company1.com uses a form-based authentication method, leave the Crawler 
Credentials fields blank and type the correct user credentials in the Form Fields text box. For example: 
UserIDField:$$UserID. 


In Form-based authentication, the first time the Web site is indexed, the credentials are sent and a 
session cookie is returned. Thereafter, QuickFinder uses the session ID in the cookie for 
authentication and the credentials are no longer sent to the Web site. 





TIP: If you are indexing more than one URL and each one requires a different set of credentials, we 
recommend that you create a separate index for each URL. 





Indexing Volumes on Remote Servers 


For information on indexing volumes on remote servers, see Step 6 on page 87 in Section 8.5.5, 
“Creating an Advanced File System Index,” on page 86. 


Generating Indexes 


After you define an index, you must generate it before it can be used for searching. Generating an 
index is the actual process where QuickFinder Server examines file server or Web server content, 
gathers keywords, titles, and descriptions and then includes them in the index. 

+ “Generating an Index” on page 91 

€ “Generating an Index For a Linux-Mounted NSS Volume” on page 91 


+ “Generating a File System Index” on page 92 
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Generating an Index 


1 On the QuickFinder Server Manager Global Settings page, click Manage in the row of the virtual 
search server that vou want to work with. 


2 Click Generate in the Action column of the index that you want to work with. 
The Active Jobs page indicates the status of the current indexing jobs. When there is no current 
index job, the status page reads No indexing jobs are currently running or defined. 


QuickFinder Server Manager - Mozilla Firefox 


File Edit View Go Bookmarks Tools Help 
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Indexing Active Jobs 
Management This is a status page that displays all currently running or defined indexing jobs. [More About Managing Indexes] 


Schedulin ind 

a a Name 
Failed Regenerate 0002 de Se chei View | Resubmit | Delete 
Indexing Regenerate 0002 = wt Sane View | Stop | Cancel | Delete 


Synchronization 





Display Search Page 





3 To cancel the current indexing jobs, click Cancel in the Status column. 


You can direct QuickFinder to automatically update your indexes on specific dates and at specific 
times by scheduling events. For more information, see Section 8.9, “Automating Index and Server 
Maintenance,” on page 96. 


Generating an Index For a Linux-Mounted NSS Volume 


To generate an index for a Linux-mounted NSS volume, the wwwrun user or www group must have 
read access to the NSS volume. To do this, verify that the wwwrun user and the www group are 
LUM-enabled, then give read access to the NSS volume by running rights and assigning the user or 
group trustee rights to the volume. 
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Generating a File Svstem Index 


When generating a file svstem index and specifving a set of filename extensions to index, vou could 
end up indexing files vou don't want. 


For example, you index your entire hard drive and look for only HTM and HTML files. There are 
about 10,000 properly matching files on your file system, but you end up with over 30,000 files in 
your index. This is because the file system scanner includes files with no filename extensions. In some 
cases, including files with no extension is better than not including them, but in this case, the index of 
all the HTML files on your hard drive is not helpful because it contains a large number of non-HTML 
files. 


To avoid this kind of situation, manually modify the QuickFinder Server configuration file: 


1 Open the /var/lib/gfsearch/Sites/default/gfind.c£g file. 


2 Inthe <Directory> of an index definition section, add the following entry next to the Include 
Extension HTM HTML line: 


IncludeNoExtension N 


This prevents files with no filename extensions from being included. 





TIP: QuickFinder Server can only index files that are accessible through local file system calls. 1f 
you mount a volume or map a drive to a remote server and the local system sees it as a local drive, 
QuickFinder Server can index it. 





8.6 Managing Existing Index Files 


After it is created, an index can then be edited or deleted. You can also view an index's log file. 


+ Section 8.6.1, “Editing an Index,” on page 92 
+ Section 8.6.2, “Deleting an Index,” on page 93 
+ Section 8.6.3, “Working with the Log File,” on page 93 


8.6.1 Editing an Index 


1 On the QuickFinder Server Manager Global Settings page, click Manage in the row of the virtual 
search server that you want to work with. 


2 On the Index Management page, click Edit in the Action column of the index you want to work 
with. 
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Indexing Index Management 


Management Once you have defined a virtual search server, you need to generate at least one index for the search server to become searchable 
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Display Search Page 





3 Make any of the changes you need to, then click Apply Settings. 


If you used the Advanced page to create the index, it appears automatically. However, you can 
also click Advanced Index Definition to make advanced changes to an index you created using the 
standard Index Definition page. 


4 If you added new paths or URLs or modified any of the existing ones, you should regenerate the 
index to include the new content. 


8.6.2 Deleting an Index 


1 On the QuickFinder Server Manager Global Settings page, click Manage in the row of the virtual 
search server that you want to work with. 


2 On the Index Management page, click Delete in the Action column of the index you want to 
delete. 


3 On the Confirm Deletion of sindexname page, click Delete Index to proceed, or click Cancel Deletion. 





WARNING: After an index has been deleted, it cannot be restored. You must generate a new 
index. 





8.6.3 Working with the Log File 


The purpose of the log file is to help you identify any errors (and their possible causes) during an 
indexing job. 


In addition to reporting when the indexing job started and stopped, the log file also lists all files that 
were indexed, files that could not be found but were linked to, and even errors that might have 
occurred during the indexing process. 
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8.7 


To view an index's log file: 
1 On the QuickFinder Server Manager Global Settings page, click Manage in the row of the virtual 
search server that you want to work with. 
2 Click View Log in the Action column of the index that you want to work with. 


3 Review the contents of the log file. 


QuickFinder Server Manager - Mozilla Firefox 
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Indexing View Indexing Log 


Management Ivar/lib/qfsearch/Sites/default/indexes/QuickFinder Server/2007-04-12; 
Scheduling 16.59.28/crawler.log 


Log Date: Apr 12, 2007 4:59:28 FM Log Size: 306,959 


Active Jobs 





Indexing Statistics: 


Items indexed: 
Items not indexed, links followed: 


Skipped items: 
Filename extension: 
File path: 
S hi 4 B File tvpe: 
Svnchronization Contents indicate "No Index": 
Contents too large: 
Empty contents: 
Display Search Page Exceeded depth limiti 
Path spec too long: 
Duplicate: 
Password protected: 
Other skip reasons: 
Hidden file: 





Errors: 
Item not found: 
unauthorized: 
Access error: 
Bad path spec: 
Timed out: 

4 














4 Click your browser's Back button to return to the Index Management page, or click Management 
in the left frame of the QuickFinder Server Manager. 


Indexing Dynamic Web Content 


Much of the content on the World Wide Web is static HTML, which means that after a static Web 
page is created, it remains the same until someone updates it. By contrast, many newer Web pages 
are created by Web applications, including servlets, Java Server Pages (JSP), Common Gateway 
Interfaces (CGI), and Perl scripts, and are usually created in response to user input. 


An example of dynamic Web content is an eCommerce Web page where items to be purchased are 
stored in a virtual shopping cart and the total cost is updated as users add or remove items from the 
shopping cart. 


Because the content changes regularly, many search engines don't index dynamic content. 


QuickFinder includes the ability to index dynamic content. The URL of dynamic Web content 
typically includes a question mark (?). You can direct QuickFinder to index these URLs by setting the 
Crawl dynamic URLs option to Yes. You could then create a scheduled event that regenerates the 
specified indexes every few minutes. 
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Controlling Access to Search Results 


Security settings let you manage access to indexed content by requiring users to authenticate to a 
server before seeing search result content. 


QuickFinder Server depends on NetIQ eDirectory to authorize each search result for a particular user 
for those documents managed by eDirectory. This allows user privileges to entire indexes rather than 
to each search result, which improves the overall speed at which search results requiring 
authentication are returned to the user. 


To configure rights-based search results: 
1 On the QuickFinder Server Manager Global Settings page, click Manage in the row of the virtual 
search server that you want to work with. 
2 Under Settings, click Security. 
3 In the Default search contexts field, specify the full context that your users share in the directory. 


Specifying the context here means that your users do not need to supply their fully qualified 
user IDs when logging in to QuickFinder. 


If User objects are stored in multiple containers, you can specify multiple contexts by separating 
them with carriage returns. For example: 


users.marketing.digitalairlines 
users.sales.digitalairlines 
users.support .digitalairlines 


4 Click Yes next to Check authorization by directory if you want QuickFinder to verify user rights to 
all files in a directory. 


QuickFinder allows access to all other files in any directory where the user has rights to at least 
one file. This method speeds up access rights checking because QuickFinder doesn't need to 
check rights for each file returned in a set of search results. 


5 Inthe Authentication realm string field, specify the correct authentication realm string, which is 
typically shown in the Web browser's login dialog box. 
If QuickFinder's realm string matches your Web server's realm string, users only need to log in 
once. 


If Apache is your Web server, refer to the Authentication, Authorization and Access Control 
(http://httpd.apache.org/docs-2.0/howto/auth.html) document on the Apache.org Web site for 
more information. 


6 Select Yes next to Require https if you want to enable HTTPS for user connections. 





IMPORTANT: We recommend that you enable HTTPS by selecting Yes, which ensures that 
usernames and passwords are encrypted as they cross network wires. 





7 In the Auto-logout time field, specify a number (in minutes) when QuickFinder should log out a 
user. 


This option is a security feature. Sometimes, users walk away from their computers. Other users 
could then have access to their search results. 


8 (Optional) Select Disable auto-logout if you don't want it used during rights-protected searches. 
We recommend that you enable this feature as an added protection for secure content. 


9 Click Apply Settings. 
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8.9 Automating Index and Server Maintenance 


You can eliminate a lot of manual work in keeping indexes up-to-date by using the QuickFinder 
Server index scheduling feature. Because the Web and file content you have indexed will eventually 
change, you can direct QuickFinder to update your indexes on specific dates and at specific times or 


intervals. 
+ Section 8.9.1, “Adding a Scheduled Event,” on page 96 
+ Section 8.9.2, “Editing or Deleting an Event,” on page 97 


8.9.1 Adding a Scheduled Event 


1 On the QuickFinder Server Manager Global Settings page, click Manage in the row of the virtual 
search server that you want to work with. 

2 Click Scheduling in the left frame of QuickFinder Server Manager. 

3 Click Add Event. 


4 Specify the month, days, days of the week, or time (in hours and minutes) when you want 
QuickFinder to run the event. 
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Indexing Schedule a New Event 


Management An event is the automatic execution of an action, such as generating or updating an index. You can tell QuickFinder Server to run an 
Schedulin event on the date and at the time you specify. [More About Scheduling Everts] 
>cheduling 


Active Jobs 
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To select multiple dates and times, hold down the Ctrl key and click all of the items you want 
added. To select consecutive items, click the first item, hold down the Shift key, then click the last 
item. 


5 Select the type of operation you want performed on your indexes. 


+ Update: QuickFinder identifies new content on Web or file servers and updates the index. 
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8.9.2 


8.10 


+ Optimize: QuickFinder improves searching performance by removing unnecessarv content 
and making the index file more compact. 


+ Regenerate: QuickFinder replaces the existing index with a newly generated one. 


6 Inthe Perform operations on column, determine whether vou want the chosen operation 
performed on all indexes or only on specified ones. 


If you have large indexes, you might consider creating multiple events that update your indexes 
at varied times. Doing so minimizes CPU utilization. By default, QuickFinder supports up to 5 
simultaneous indexing sessions. All other indexes wait until a previous index job has completed. 
You can control the number of simultaneous indexing jobs from Services Settings. (See 

Section 7.3, “Configuring Services Settings,” on page 47.) 


7 Click Apply Settings. 


Editing or Deleting an Event 


1 On the QuickFinder Server Manager Global Settings page, click Manage in the row of the virtual 
search server that you want to work with. 


2 Click Scheduling in the left frame of QuickFinder Server Manager. 


If no events have been scheduled, refer to Section 8.9.1, “Adding a Scheduled Event,” on page 96 
for instructions on adding a scheduled event. 


To edit a scheduled event, click Edit in the row of the event you want to modify. 
Make the desired changes, then click Apply Settings. 


To delete a scheduled event, click Delete in the row of the event you want to delete. 


oa B Ww 


Click Delete Event to confirm the deletion, or click Cancel Deletion. 


Backing Up Your Virtual Search Server Files 


As with any valuable data, you should make sure that your virtual search server files are backed up. 
At minimum, you should back up your index files, which by default are stored in /var/lib/ 
qfsearch/docs/index.html. 


If you have customized templates, you might also want to back them up. By default, they are stored 
in /var/lib/qfsearch/Templates. 
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Svnchronizing Data Across Multiple 
QuickFinder Servers 


If vou are running multiple installations of QuickFinder Server across several servers, vou can 
simplifv management tasks, such as re-generating indexes and sharing configuration settings, by 
configuring all of your servers into a single QuickFinder Synchronization cluster. 


QuickFinder Synchronization lets you designate one QuickFinder server as the search master from 
which updated indexes, templates, and configuration settings are systematically sent out to all other 
QuickFinder servers defined as part of a QuickFinder Synchronization cluster. Each of the other 
servers must be configured to receive updates from the search master. 


QuickFinder Synchronization offers several key benefits: 


+ Saves system resources on all other machines because they do not need to regenerate indexes 
themselves. 


¢ Lets an administrator manage all other QuickFinder servers from a single interface. 


+ Regenerates indexes nightly on the search master and then pushes them out to all other 
QuickFinder servers. 


+ Offers fault tolerance and load-balancing benefits by hosting QuickFinder indexes, templates, 
and configuration settings across multiple servers; if one server goes down, your users do not 
know the difference. 


You might want to use a Novell iChain server to front the QuickFinder Synchronization cluster 
servers. This offers basic load-balancing capabilities using revolving IP addresses. For more 
information, see the Novell ¡Chain 2.3 Administration Guide (http://www.novell.com/ 
documentation/ichain23/index.html). 


¢ Ensures that all QuickFinder servers within a cluster are using the same version of an index. This 
means that you never have a server with a newer version of an index than all other servers. Even 
the search master won't use the newly generated indexes unless all of the servers in the cluster 
can also do so. 





IMPORTANT: QuickFinder Server Synchronization is different from Cluster Services. Novell 
Cluster Services groups two or more OES 11 SP2 servers together for the sake of failover and to 
ensure server availability. A QuickFinder Synchronization cluster synchronizes indexes, templates, 
and configuration settings between two or more QuickFinder servers, thus reducing the 
administrative work of updating the same index across several QuickFinder servers. (See Chapter 6, 
“Configuring QuickFinder Server for Novell Cluster Services,” on page 31.) 





To enable QuickFinder Synchronization, you need to do the following; 


¢ Configure each QuickFinder server and virtual search servers that you want included in the 
cluster to receive updates. See Section 9.1, “Setting Up a Search Server to Receive Updates,” on 
page 100. 
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9.1.1 


+ Designate one of the QuickFinder servers as the search master and configure it to send updates 
to other QuickFinder servers by identifying each of the other servers to be included in the 
cluster. A search master can continue to serve as a QuickFinder server, and you can have more 
than one search master in your QuickFinder Synchronization cluster. See Section 9.2, “Setting 
Up a Search Master and Defining a Cluster,” on page 102. 


+ Configure which indexes on the search master are included in the synchronized cluster. See 
Section 9.3, “Updating a Virtual Search Server,” on page 105 


Although the order in which you perform these tasks is not critical, we recommend that you set up 
the Search servers intended to receive cluster data first, and then configure a QuickFinder server as 
the search master and use it to define the synchronization cluster. 

+ Section 9.1, “Setting Up a Search Server to Receive Updates,” on page 100 

€ Section 9.2, “Setting Up a Search Master and Defining a Cluster,” on page 102 

+ Section 9.3, “Updating a Virtual Search Server,” on page 105 


Setting Up a Search Server to Receive Updates 


For each QuickFinder server you want included in a synchronization cluster, you must configure it to 
receive updates. Also, each virtual search server must be configured to receive updates. You must 
make the same changes on every server to be included in the cluster. 

+ Section 9.1.1, “Setting Up a QuickFinder Server to Receive Cluster Data,” on page 100 

è Section 9.1.2, “Setting Up a Virtual Search Server to Receive Updates,” on page 102 


Setting Up a QuickFinder Server to Receive Cluster Data 


1 On the Global Settings page of QuickFinder Server Manager, click Synchronization under Services 
Settings. 


2 Under General Synchronization Settings, click No next to Will this machine send cluster data. 
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Virtual Search Servers QuickFinder Server Synchronization 


QuickFinder Server Synchronization lets you manage multiple QuickFinder Server installations from a single administration 
interface. Changes made to one server are automatically replicated to the other servers in the cluster (see "Defined Clusters" 
below). The ability to synchronize QuickFinder Server files includes newly generated indexes, configuration settings, and search 
results templates. [More About QuickFinder Server Synchronization] 





General Synchronization Settings 
Will this machine send cluster data: 
Will this machine receive cluster data: 


Require admin authorization when receiving cluster data: 
Require HTTPS for all cluster communications: 


Maximum number of transmission attempts: 
Number of seconds between transmission attempts: 


Synchronization Synchronization Logging Settings 


Enable synchronization logging: Yes No 


Log synchronization messages to: File | View Log 


New log when Synchronization Manager loads: f'Ves No 


Maximum log size (bytes): 30000 


Defined Clusters 

















3 Click Yes next to Will this machine receive cluster data. 


4 (Optional) Click Yes next to Require admin authorization when receiving cluster data if you want to 
require incoming requests to provide administrator credentials before proceeding. 


If the risk of intrusion to your server is low—for example, if your server is behind a firewall —it 
is better to disable this feature by clicking No. Enabling it can slow down system performance 
because of the rights checking that happens each time a request to send cluster data is received 
by the server. 


5 (Optional) Click Yes next to Require HTTPS for all cluster communications to require a secure 
sockets layer (SSL) connection from a search master attempting to send updated data to this 
Search Server. 


6 Inthe Maximum number of transmission attempts field, specify the number of times QuickFinder 
should attempt to connect to other servers in a cluster. 


7 Inthe Number of seconds between transmission attempts field, type the number of seconds 
QuickFinder should wait between transmission attempts. 


You should set this number high enough to allow a server to fully restart after a failure. 


8 Click Apply. 


After you have configured a QuickFinder server to receive data, you must also configure at least one 
virtual search server to receive updates. See Section 9.1.2, “Setting Up a Virtual Search Server to 
Receive Updates,” on page 102 for more information. 
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9.1.2 Setting Up a Virtual Search Server to Receive Updates 


1 On the Global Settings page of QuickFinder Server Manager, select a virtual search server from 
the list by clicking Manage. 


2 Under Settings, click Synchronization. 


3 Click Yes next to Let virtual search server receive cluster data. 
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Indexing Synchronization Settings 
Management If vou are running multiple installations of QuickFinder Server across several machines, you can simplify management tasks, such 


Schedulin as re-generating indexes, by synchronizing your QuickFinder Servers. By designating one ofthem as a search master, you can use 
>cheduling itto push new or updated indexes, virtual search server configuration settings, and new or updated templates to all other 
Active Jobs QuickFinder Servers in your cluster. [More About Syndronization Settings] 


Receive Settings 


Let Virtual Search Server receive cluster data: “ Yes “ No 


Apply Settings 


Settings 


Synchronization 





Display Search Page 





4 Click Apply Settings. 


9.2 Setting Up a Search Master and Defining a Cluster 


After you have configured both the QuickFinder servers and virtual search servers for each server to 
be included in the QuickFinder Synchronization cluster, you now need to configure a search master 
and define one or more clusters. 


+ Section 9.2.1, “Setting Up a QuickFinder Server to Send Updates,” on page 102 


+ Section 9.2.2, “Defining a Synchronization Cluster,” on page 104 


9.2.1 Setting Up a QuickFinder Server to Send Updates 


1 On the Global Settings page of QuickFinder Server Manager, click Synchronization under Services 
Settings. 


2 Under General Synchronization Settings, click Yes next to Will this machine send cluster data. 
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QuickFinder Server Synchronization lets you manage multiple QuickFinder Server installations from a single administration 
interface. Changes made to one server are automatically replicated to the other servers in the cluster (see "Defined Clusters" 
below). The ability to synchronize QuickFinder Server files includes newly generated indexes, configuration settings, and search 
results templates. [More About QuickFinder Server Synchronization] 





Default Settings 
General 


General Synchronization Settings 
Will this machine send cluster data: 
Will this machine receive cluster data: 


Require admin authorization when receiving cluster data: 
Require HTTPS for all cluster communications: 


Search 
Print 
Index 
Security 


alts piste Maximum number of transmission attempts: 


Number of seconds between transmission attempts: 


Synchronization Synchronization Logging Settings 


Enable synchronization logging: Yes No 


Log synchronization messages to: File | View Log 


New log when Synchronization Manager loads: f'Ves No 
Maximum log size (bytes): 30000 


Defined Clusters = 


¡A 

















3 Click No next to Will this machine receive cluster data. 


If you want the search master to receive updates from another server in the cluster, select Yes. 
You can configure a QuickFinder server to both send and receive updates. 


4 Because this is the search master and will probably not be receiving cluster data, click No next to 
Require admin authorization when receiving cluster data. 


5 (Optional) To ensure a secure connection with the other QuickFinder Servers, click Yes next to 
Require HTTPS for all cluster communications. 


If the risk of intrusion to your server is low—for example, if your server is behind a firewall —it 
is better to disable this feature by clicking No. Enabling it can slow down system performance 
because of the rights checking that happens each time a request to send cluster data is received 
by the server. 


6 Inthe Maximum number of transmission attempts, specify the number of times the search master 
should attempt to transmit data to an unresponsive QuickFinder Server in the cluster before 
quitting. 

After the number of transmission attempts specified here is reached, QuickFinder stops trying to 
transmit data to other servers in a cluster. If the e-mail notification capability has been enabled, 
then QuickFinder also sends an e-mail identifying the cause of the problem. For information 
about enabling the e-mail feature, see Section 7.3, “Configuring Services Settings,” on page 47. 


7 Inthe Number of seconds between transmission attempts, type the number of seconds QuickFinder 
should wait between each transmission attempt specified in the Maximum Number of 
Transmission Attempts. 


8 (Optional) Under Synchronization Logging Settings, click Yes next to Enable synchronization logging 
if you want QuickFinder to log cluster-related errors. 
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9 (Optional) Specifv where vou want log results displaved bv selecting one of the following 
options from the Log synchronization messages to drop-down list: 


¢ File: When this option is selected, you can click View Log next to the Log synchronization 
messages to drop-down list to display the log results in your browser. 


+ Console: When this option is selected, the synchronization logging settings writes the logs 
to /var/opt/novel1/tomcat6-32bit/logs/catalina.out file. 


+ Both: Displays results in both your browser and at the system console. 


10 (Optional) Click Yes next to New log when synchronization manager loads to start a new logging 
session when the synchronization manager servlet is loaded (or restarted). 


The contents of the current log are replaced with the new data. 


11 (Optional) In the Maximum log size field, specify the maximum file size of the log file (in bytes) 
before a new one is started. 


The number you specify here is divided evenly between two log files. For example, if you 
specify 30000, each log file allows up to 15000 bytes of logged data. This ensures that you always 
have at least 15000 bytes of logged synchronization data. 


12 Click Apply. 


9.2.2 Defining a Synchronization Cluster 


You must identify each of the QuickFinder Servers (and their virtual search servers) that you have 
configured to receive cluster data. To do so, you must know the URL of each server to be included, as 
well as the names of each virtual search server on each of the QuickFinder servers that you want 
included. 


Also, if you have configured any of the participating servers to require administrator authorization 
when being accessed by the search master, you must provide their administrator usernames and 
passwords. 


1 On the Global Settings page of QuickFinder Server Manager, click Synchronization under Services 
Settings. 
2 Under Defined Clusters, specify a name for the new cluster in the Cluster <number> Name field. 


3 In the Server <number> URL field, specify the URL of a QuickFinder Server to be included in the 
cluster. 


4 Inthe Virtual Search Server field, specify the name of a virtual search server. 


5 (Optional) If you enabled (or will enable) the Require admin authorization when receiving cluster 
data feature on this QuickFinder Server, specify the admin username and password in the 
appropriate fields. 


6 (Optional) To add another server to the cluster, click Add Server and repeat Step 1 through Step 5. 
7 Click Apply. 


The synchronized cluster is formed. You can add additional clusters by clicking on the Add New 
Cluster tab. 
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9.3 
9.3.1 


9.3.2 


Updating a Virtual Search Server 


Setting Up a Virtual Search Server to Send Updates 


The last step in setting up QuickFinder Synchronization is to configure one or more virtual search 
servers on your search master to send updates. 


1 On the Global Settings page of QuickFinder Server Manager, click Manage and select a virtual 
search server from the list. 

Under Settings, click Synchronization. 

Under Send Settings, click Yes next to Let virtual search server send cluster data. 

Click Edit next to the Under name of clusters to send to field. 


Select one or more clusters that you have defined, then click Apply. 


O ao A O N 


Select one or more indexes from Indexes to send to clusters. 


The indexes you select are sent to the designated clusters every time they are regenerated 
(manually or scheduled). Also, you can click the Indexes button under the Send indexes section to 
send these indexes immediately to the clusters vou've selected. 


7 Click Apply Settings. 


Sending Synchronization Updates Manually 


After QuickFinder Synchronization is configured properly, you can go to a virtual search server and 
send index, template, and configuration updates at any time. For example, if you need to make a 
correction or addition to a template, you can open the Synchronization Settings page and click 
Templates under Send Now and the templates are then pushed out to all other virtual search servers in 
the clusters you selected in the Name of Clusters to Send To field. 


1 On the Global Settings page of QuickFinder Server Manager, click Manage and select a virtual 
search server from the list. 
2 Under Settings, click Synchronization. 


3 Under Send Now, click the Indexes, Templates, or Settings button to send updates from the current 
virtual search server to all others in the cluster. 


When the process is underway, a confirmation page is returned. You don't need to wait for the 
process to complete before continuing to work in QuickFinder Server Manager. 


Synchronizing Data Across Multiple QuickFinder Servers 105 


106 OES 11 SP2: Novell QuickFinder Server 5.0 Administration Guide 


10.1 


Optimizing Search Results 


There are a number of ways you can optimize the performance of your virtual search servers. Some 
of the optimization strategies are put into place as you plan and create your search solution. Others 
are done after your search solution has been created. 


This section discusses things you can do after your search solution is already in place. It includes the 
following topics: 


+ 


+ 


+ 


+ 


Section 10.1, “Reviewing Query Log Reports,” on page 107 

Section 10.2, “Improving Search Results through Intelligent Indexing,” on page 108 
Section 10.3, “Excluding Documents from Being Indexed,” on page 109 

Section 10.4, “Modifying Document Descriptions in a Search Results List,” on page 110 
Section 10.5, “Improving Search Results,” on page 110 

Section 10.6, “Helping Users Avoid Failed Searches,” on page 119 

Section 10.7, “Weighted Queries,” on page 119 

Section 10.8, “Ensuring Optimal Search Speed,” on page 120 

Section 10.9, “Making Good Use of Document Fields,” on page 120 

Section 10.10, “Searching XML Documents,” on page 121 

Section 10.11, “Using the &filter Query Parameter,” on page 121 


Reviewing Query Log Reports 


Before you begin changing various QuickFinder settings, set up and review query log files for clues 
about where your search service needs improvements. 


Query logging captures many details about user queries, including total number of searches 
performed (for the current logging period), top 100 search terms, load statistics, and the number of 
print jobs performed. It also provides information about queries that resulted in a “not found.” 


1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 


2 


virtual search server that you want to work with. 


Click General under Settings. 


3 To view an existing log report, select a report from the Available log reports list, then click View 


Report. 
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Indexing 
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QuickFinder Server - Query Report 


This report provides statistical information for the virtual search server. It summarizes historical information related to the 
performance of your QuickFinder Server. This information can be used to improve the search services you provide to your 
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Report Summary 


Top 10 Searches 


Total Requests: More... 
Templates Used: 
Unique Users: 


More... Top Indexes 


More... 
Searches 


Total Searches: 
Successful Searches: 
Not Found Searches: 
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If there are no logs listed, vou have not vet generated a log report. 
4 (Optional) Click Generate Current to create a report of the current (not vet completed) log period. 


Depending on the amount of information in the logs, this process could take anvwhere from a 
few seconds up to several hours to complete. After a new report is generated, it appears in this 
list. 


10.2 Improving Search Results through Intelligent Indexing 


You can improve the accuracy of your search results by following these indexing guidelines: 


+ When defining and creating your indexes, start with the highest possible Web site URLs and file 
system paths. 


+ If content is showing up in your search results that you don't want included, try removing some 
paths or URLs from your defined indexes. Also, try excluding specific subdirectories that you 
know or suspect might contain content that you don't want searched. 


+ Ifyou've indexed too many file types and cluttered your search results, try removing file types 
that you don't want indexed by using the Extensions to Exclude option on the Define Index page. 
See “Creating an Advanced Crawled Index” on page 80 and “Creating an Advanced File System 
Index” on page 86 for more information. 


+ Use the Robots meta tag (http://www.robotstxt.org/meta.html) in your Web site's content. See 
“Using the Robots Meta Tag” on page 109. 
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10.3 


10.3.1 


¢ Exclude documents or specific sections of documents, including headers, footers, and navigation 
bars. See Section 10.3, “Excluding Documents from Being Indexed,” on page 109. 


+ Use the Robots Exclusions standard (http://www.robotstxt.org/robotstxt.html) (the /robots.txt 
files are found on almost all Web sites). The Index Definition's excludePaths settings are 
automatically combined with the robots.txt settings when crawling and indexing. You can 
turn robots.txt support on or off. 


Excluding Documents from Being Indexed 


One way to improve search results is to guard what content is actually indexed, thus clearing a path 
for relevant information. 


+ Section 10.3.1, “Using the Extensions to Exclude Option,” on page 109 


Using the Extensions to Exclude Option 


You can use the Extensions to Exclude option to direct QuickFinder to ignore specific file types. For 
example, if you don't want Word or PowerPoint documents to be included in search results, you can 
specify DOC and PPT in the Extensions to Exclude field. When these document types are encountered 
during an indexing job, QuickFinder skips them. 


For more information on the Extensions to Exclude option, see “Creating an Advanced Crawled 
Index” on page 80 and “Creating an Advanced File System Index” on page 86. 


Using the Extensions to Include Option 


As mentioned above, you can use the Extensions to Exclude option to direct QuickFinder to ignore 
specific file types. However, if you can't specify all of the extensions to exclude, use the Extensions to 
Include option and specify all acceptable file extensions. A typical list would specify HTM, HTML, 
PDF, TXT, and DOC. 





TIP: When entering extensions in the Extensions to Exclude box, separate each extension by a space or 
a hard return. Don't use commas. For example: 


htm html pdf txt doc 





Using the Robots Meta Tag 


Another effective way of controlling what QuickFinder indexes is to use the Robots meta tag. This tag 
is inserted into header section of a document and contains instructions about what should (or should 
not) be indexed. 


When a Web-based search engine encounters a document containing the Robots meta tag, the search 
engine does as the meta tag instructs. 


There are several values you can specify in the Robots meta tag 

NOINDEX: Indicates that the document is not to be indexed. 

NOFOLLOW: Indicates that hypertext links in the document are not to be crawled. 
FOLLOWINDEX: Indicates that hypertext links in the document should be crawled. 


ALL: Indicates that the document can be indexed and all links can be crawled. 
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10.5 


NONE: Indicates that the document is not to be indexed and that hvpertext links are not to be 
crawled. 


To include the Robots meta tag, use this svntax in the header section of the document: 


<META name="Robots” content="value, optional value'- 


Using the Robots Comment Tag 


You can also use the Robots Comment tag to exclude specific sections of HTML documents from your 
search results. For example, you might not want such sections as repetitive headers, footers, 
navigation bars, and server-side includes to be indexed. 





TIP: You can also place these tags at the top and bottom of all include files so these sections are never 
indexed when they are part of a larger document. 





To direct QuickFinder where to begin skipping content while indexing: 


1 At the point in your HTML document where you want QuickFinder to begin skipping content 
while indexing, use the following tag: 


<!--*Robots NoIndex- > 
2 Just after the content you want skipped, use the following tag: 
<!--*Robots Index- > 


3 Save your changes and index (or reindex) the content. 


Modifying Document Descriptions in a Search Results List 


QuickFinder returns a description of each hit that is listed on the search results page. By default, the 
following information is returned for each result: 

¢ Description field 

+ Summary field 

+ Abstract field 

¢ The first 255 characters of the document (beginning with first heading and skipping links) 
The first three fields are taken from the content of meta tags in HTML documents or from document 
summary fields in other document types such as Word or PDF files. If these tags or fields are not 
defined, QuickFinder tries to find the first heading and begin selecting words. If it can’t find a 


heading, it begins at the top of the document and selects the first 255 relevant display bytes as the 
description. 


Improving Search Results 


There are many things you can do to improve the speed, accuracy, and relevance of search results for 
end users. 

+ Section 10.5.1, “Improving the Relevance of Search Results,” on page 111 

+ Section 10.5.2, “Using Stop Words Processing to Improve Search Speed,” on page 112 

+ Section 10.5.3, “Using Best Bets to Help Users Find the Right Information,” on page 113 
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+ Section 10.5.4, “Using Synonyms to Broaden Search Results,” on page 114 
+ Section 10.5.5, “Redirecting Searches,” on page 117 
+ Section 10.5.6, “Creating or Editing the Redirection URLs List,” on page 117 


10.5.1 Improving the Relevance of Search Results 


QuickFinder uses a sophisticated relevance-ranking algorithm. During a search, QuickFinder 
considers 
+ The number of times words appear in a document 


¢ The proximity of words in a multiple word search (the closer the words are to each other, the 
more relevant the document is) 


¢ The order of words in a multiple-word search (the exact order of words is more relevant) 


+ The location of words in a document (specifically words that appear in a meta tag, title, body, 
header, footer, etc.) 


¢ The formatting of words in a document (such as bold, font type and size, etc.) 
€ Query weighting in a multiple query scenario 


+ The number of times words occur within an entire index (for example, the word “the” has low 
relevance) 


¢ The date of the document 

+ The depth of the document 

¢ The index, path, and URL weights 

¢ Off-site links 

+ Synonyms (synonym-derived hits are slightly less relevant by default) 


To illustrate how these criteria work, consider the following examples: 


¢ Words in bold are more relevant than regular words. 


+ Words contained in the <Title> tag are more relevant than words contained within the <body> 
tag. 

+ Words contained in the Keywords and Description meta tags are more relevant than content 
words. 


¢ Words contained within the <A HREF=> tag used for creating links are less relevant than words 
outside of this tag. 


+ A document containing a specified search term multiple times is more relevant than a document 
that contains the search term only once. 


+ A word within a 36-point body text is more relevant than within 4-point footer text. 


+ Documents returned from a query that is weighted at 100% are more relevant than those 
returned from a 50% weighted query. This is normally used in multi-query searches where each 
query has a specified weight. For example: 


query0=linux&weight 0=100&queryl=groupwise&weight1=100 


In addition to QuickFinder’s inherent capabilities, you can further enhance the speed and accuracy of 
search results by enabling and configuring additional search features. 
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10.5.2 Using Stop Words Processing to Improve Search Speed 


Sometimes users include irrelevant words in their search strings, such as the conjunctions and, to, 
and of. These are referred to as stop words. The Stop Words feature of QuickFinder removes all 
occurrences of stop words from the search string before performing a search, except in the following 
situations. 

+ Stop words processing has been turned off. 

¢ You prepend the word with a plus (+) sign (for example, +the). 

¢ They are the only words in the query. 


¢ They occur within a phrase. 





NOTE: The Boolean operators AND, OR, and NOT are treated as regular words if they are lowercase 
or in quotes and as Boolean operators if they appear in uppercase. For example: 


jack and jill (searches for three words) 
“jack AND jill” (also searches for three words) 
jack AND jill (searches for two words) 





A set of common stop words is included in QuickFinder, but you can easily add your own, or remove 
any of the existing stop words. See “Editing the Stop-Words List” on page 65 for more information. 


Before a virtual search server can use stop words processing, it must first be enabled on the 
QuickFinder server on the Global Settings page of QuickFinder Server Manager. 

+ “Enabling Stop Words Processing on a QuickFinder Server” on page 112 

+ “Enabling Stop Words Processing on a Virtual Search Server” on page 112 


Enabling Stop Words Processing on a QuickFinder Server 


1 On the Global Settings page of QuickFinder Server Manager, click General under Default Settings. 
2 Under Query Settings, click Yes next to Enable stop-words processing. 


3 (Optional) Click Edit List to modify the default list of stop words, modify the list, then click 
Apply. 
4 Click Apply Settings. 


Enabling Stop Words Processing on a Virtual Search Server 


1 On the QuickFinder Server Manager Global Settings page, click Edit in the row of the virtual 
search server that you want to enable stop words processing on. 


2 Under Settings, click General. 
3 Click Yes next to Enable stop-words processing. 


4 (Optional) Click Edit List to modify the default list of stop words, modify the list, then click 
Apply. 
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5 Click Apply Settings. 


Using Best Bets to Help Users Find the Right Information 


Best bets is a secondary results list that appears at the top of the search results page. It is generated 
from a special-purpose index, which is an index created for the express purpose of generating a best 
bets results list. 


A best bets list can help users find what they are looking for more quickly by bringing the most 
popular or most important things to the top of the results page. 


A special-purpose index typically contains information about the most popular, most recent, or most 
important documents. 
¢ “Enabling Best Bets on a QuickFinder Server” on page 113 


+ “Enabling Best Bets on a Virtual Search Server” on page 114 


Enabling Best Bets on a QuickFinder Server 


1 On the Global Settings page of QuickFinder Server Manager, click Search under Default Settings. 
2 Click Yes next to Enable Best Bets search results. 


3 (Optional) If you want the best bets results to show automatically on the search results page, 
click No next to Show Best Bets searches by default. 


4 (Optional) In the Maximum number of Best Bets results field, type the maximum number of best 
bets results to be returned on each search results page. 


5 Click Apply Settings. 
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Enabling Best Bets on a Virtual Search Server 


1 On the Global Settings page of QuickFinder Server Manager, click Manage in the row of the 
virtual search server that vou want to modifv. 


2 Under Settings, click Search. 
3 Click Yes next to Enable Best Bets search results. 


4 Click Edit next to the Default Best Bets indexes to search field and select the indexes for use with 
best bets. 


5 If you want the best bets results to show automatically on the search results page, click Yes next 
to Show Best Bets searches by default. 


6 In the Maximum number of Best Bets results field, specify the maximum number of best bets results 
to be returned on each search results page. 


7 (Optional) In the Minimum Best Bets relevance field, type the number of low relevance documents 
you want removed from the best bets display list. 


8 Click Apply Settings. 


Using Synonyms to Broaden Search Results 


When enabled, a synonym-enhanced search returns documents in the search results that contain 
synonyms of the user's original search terms. This can lead users to documents they might not 
otherwise find because they don't know the exact terminology. 


If search results contain the original term, the relevance does not change. If results contain the 
original term and a synonym, relevance is boosted. If results contain only synonyms, relevance is 
adjusted by the value entered for the Relevance of Synonym-derived Search Results setting, which is 
usually slightly lower than the normal relevance. 


Common synonyms are included in the QuickFinder Synonym List, but you can add new ones and 
delete existing ones. 


When enabling synonym enhanced searches, keep the following things in mind: 


+ A svnonvm-derived search result can be slightly less relevant than the original term. 


+ A document containing both the original search term and one of its synonyms is more relevant 
than a document with only the original term. 


+ Administrators control the Synonym List. 


+ Synonyms enhancement is not performed within the FileFilter section of a search. 
This section contains the following information: 


¢ “Enabling Synonym-Enhanced Searches on a Virtual Search Server” on page 114 
9 “Editing the Synonyms List” on page 115 


Enabling Synonym-Enhanced Searches on a Virtual Search Server 


1 On the Global Settings page of QuickFinder Server Manager, select a virtual search server from 
the Virtual Search Server List, then click Manage. 


2 Click General under Settings. 
3 Click Yes next to Enable synonym-enhanced search results. 


4 Click Apply Settings > Back to General Settings to save any changes you have made. 
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Clicking Edit List causes anv unsaved changes to be lost. 


5 (Optional) To reduce the relevance factor, click Edit List to the right of Enable synonym-enhanced 
search results, specify a number in the Relevance of synonym-derived search results field, then click 


Apply. 
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Synonym List 


Following is the complete list of synonyms. The list is divided into meaning sets, each set comprising two or more 
terms on a single line. You may freely add, remove, or modify any meaning set or synonym term. [More About Synonyms] 


Make sure to preserve the proper formatting for a meaning set and the individual terms: [??]term1[??]term2 
Where the first '7' indicates if the other terms in the set may use this term as a synonym 
And where the second '7' indicates if this term may map to the other synonyms in the set 


438 total synonyms comprising 139 meaning sets 


[++]multiple[++]many[++]numerous[-+]manifold[-+]various 
[++]application[+-]program[++]product 
[++]clear[++]delete[++]erase[++]remove[-+]discard[-+]eliminate 
[++]salvage[++]recover[++]restore[++]undelete[-+]"bring back"[-+]reclaim 
[++]secure[++]safe[++]security[-+]private[-+]protected[-+]restriction[-+]"access controlled" 
[++]cascade[-+]flow[-+]"flow down" 

[++]browse[++]scan[-+]scroll 

[++]position[++]placement[++]location 

[++]"organizational unit"[++]container[+-]account 

[++]settings[++]configuration[-+]registry 

[++]nds[++]ds[+-Jedirectory 
ls+lioual++leende: 
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Display Search Page Use the browser's find feature to find existing synonyms 
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+ lannlet 


The purpose of this feature is to keep long queries from timing out. Because a single search term 
could potentially have many synonyms, this feature lets you reduce the relevance factor, which 
reduces the total number of hits. 


A value below 100 generates a second query containing the synonyms where the query weight is 
slightly lower than the original query weight. A value of 100 simply adds the synonyms to the 
user's original query and gives all words equal weight. 


The most effective relevance numbers are in the 90s. Searches are fastest when you set the 
relevance to 100. However, you lose the benefit of synonym-derived search results when you set 
this number too high. 


6 Click Apply Settings. 


Editing the Synonyms List 


1 On the Global Settings page of the QuickFinder Server Manager, select a virtual search server 


from the Virtual Search Server List, then click Manage. 


2 Click General under Settings to open the General Settings page. 


3 Set Enable synonym-enhanced search results to Yes. 


4 Click Apply Settings > Back to General Settings to save any changes you have made. 


If you click a different option before you save, changes you make on this page are lost. 


5 Click Edit List to the right of the Enable synonym-enhanced search results. 
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6 Add or delete words as necessary to customize the synonym list. 


The Synonym List contains a list of default synonyms included with QuickFinder. The 
synonyms are grouped by sets. A set is one row of synonyms in the list and contains words that 
are common synonyms of other word in the same set. 


Each word in a set is preceded by a pair of brackets containing a combination of two plus (+) or 
minus (-) signs, which identify how the word they precede is to be interpreted. 


Following table summarize your decision to use signs in a set: 


Signs Description 


[++] A [++] before a word signifies that other words in the set can use this word as 
a synonym, and this word can use other words in the set as its synonyms. 


[+-] A [+-] before a word signifies that the other words in the set can use this 
word as a synonym. However, this word cannot use other words in the set as 
its synonyms. 


[-+] A [-+] before a word signifies that other words in the set cannot use this word 
as a synonym. However, this word can use other words in the set as its 
synonyms. 


For example: 
[++]jobs[++}tasks[+-]threads signifies the following: 
¢ The word tasks can use jobs and threads as synonyms 


+ The word jobs can use tasks and threads as synonyms. 
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+ When a user searches for threads, only the word threads is considered for search and the rest 
of the words in the set are ignored. 


+ The word threads cannot use jobs and tasks as its synonym. 
[++]certification[++]license[-+]permission signifies the following: 

+ The words certification and license cannot use the word permission as a synonym. 

+ The word permission can use both the words in the set as synonyms. 


+ When a user searches for the words certification or license, the word permission is not 
considered for search. 


7 When you have finished making changes by adding or deleting words and assigning the proper 
plus (+) or minus (-) symbols, click Apply. 


10.5.5 Redirecting Searches 


The redirection feature lets you specify key words that redirect the user’s Web browser to a specific 
URL. 


To enable search term redirection on a QuickFinder server: 


1 On the Global Settings page of QuickFinder Server Manager, click Search under Default Settings. 
2 Under Query Settings, click Yes next to Enable search term redirection. 


3 (Optional) Click Edit List to create (or modify) the list of redirection terms and their associated 
URLs. 


For more information, see “Creating or Editing the Redirection URLs List” on page 117. 


4 Click Apply Settings. 


10.5.6 Creating or Editing the Redirection URLs List 


1 On the Global Settings page of QuickFinder Server Manager, click Search under Default Settings. 
2 Click Apply Settings > Back to Search Settings to save any changes you have made. 

Clicking Edit List causes any unsaved changes to be lost. 
3 Click Edit List to create (or modify) the list of redirection terms and their associated URLs. 
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4 In the When searching for term field, specify a search term. 
5 Inthe Go to URL field, specify the associated URL. 


6 (Optional) Select the Only if search fails option if you want the search query to be redirected if a 
search fails to return any results. 


7 (Optional) If you want additional control over when a search term is redirected to an alternate 
URL, check the Don't redirect if check box and specify one or more of the following conditions: 


+ Select Body if you want redirection disabled when a specific word or phrase is found in the 
body of a document returned during a search. From the Conditions drop-down list, select a 
condition (equals, begins with, contains, or ends with) and specify a word or phrase in the 
text field at the right. 


+ Select Response Code if you want redirection disabled when a specific response code is 
returned. For example, if a user enters a search term that you have identified for redirection 
and a 404 Not Found error is returned for any reason, QuickFinder won't redirect the 
request to the alternate URL. Specify the response code to be used in the text field to the 
right of the Conditions drop-down list. 


¢ Select Header if you want redirection disabled when a specific word or phrase is found in 
the header section of a document returned during a search. From the Conditions drop-down 
list, select a condition (equals, begins with, contains, or ends with) and specify a word or 
phrase in the text field at the right. 


8 Click Apply, then click Apply Settings. 
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Helping Users Avoid Failed Searches 


If QuickFinder cannot locate anv documents matching a user's search querv, a Not Found message is 
returned. This is sometimes called a failed search. When vou enable the search expansion feature, 
QuickFinder directs failed searches to additional indexes that vou create for use with expanded 
searches. 


The best wav to implement expanded searches is to create special indexes that are targeted to verv 
specific purposes. For example, vou might create an index dedicated to sales reports information, 
which could help users who are trying to pinpoint sales reports for specific fiscal quarters. (For more 
information about how to create and manage indexes, see Section 8.5, “Creating Indexes,” on 

page 79.) 


To enable search expansion on a virtual search server: 
1 On the Global Settings page of QuickFinder Server Manager, select a virtual search server from 
the Virtual Search Server List, then click Manage. 
2 Under Settings, click Search. 
3 Under Query Settings, click Yes next to Enable search expansion. 
4 Click Edit next to the Default search expansion indexes and select the indexes to be used. 


5 Click Apply, then click Apply Settings. 


Weighted Queries 


A weighted query is used anytime you want to modify the order or relevance of certain hits in a 
user's normal search results list or when you want to add additional search results users might not 
have identified in their queries. 


QuickFinder allows users to submit more than one query item as part of a single search request. 
The following query parameters are combined to identify a single search query item: 


&filter#= 
&filteroperator#= 
&operator#= 
&query#= 
&weight#= 


One use of this feature could be to provide profile-enhanced search requests. For example, the 
following query returns French product downloads higher up in the search results list but does not 
eliminate results of any other language downloads: 


£query0=product+downloadseweight0=1008query1=*language=frenchsweight1=90 


This example directs QuickFinder to perform two completely separate searches. The search results 
from the two queries are then merged based on the relevance of the individual search results and the 
weighting of the respective query that produced them. 


Another example might be to give the search results from one index more or less relevance than the 
search results of another index when performing a multiple-index search. For example, the search 
results from Novell might be more relevant than the search results from Novonvx. 


To send multiple query items, these parameters must be grouped by using a number (+) at the end of 
the parameter name so they are interpreted properly. The numbering should begin at 0 or 1 and 
increment sequentially for each additional query item. 
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10.8 


10.9 


Ensuring Optimal Search Speed 


After a virtual search server has been accessed, all of its configuration files are read into memorv. For 
speed reasons, the virtual search server remains cached in memorv until a period of inactivitv has 
elapsed. The virtual search server is then dvnamicallv removed from memorv until its next use. 
Because of this, the first time a virtual search server is accessed is usuallv the slowest. 


However, there are other factors that can affect the performance of vour QuickFinder services. As 
with anv software, the amount of available svstem resources (CPU, RAM, and hard drive) affects 
QuickFinder Server performance. QuickFinder speed depends on the following factors: 

¢ System processor speed 

+ Number of processors 

+ Amount of system memory (RAM) 

+ Number of hosted virtual search servers 

+ Number of indexes within each virtual search server 

+ Number of files included within each index 

+ Number of indexes included within each query 

+ Number of queries performed at one time 

+ Complexity of users’ queries 


+ Number of search results returned with each results page 








+ Number of concurrent active indexing jobs 


¢ Other functions being performed by your server 


Adjusting any of these values can have a significant impact on the performance of your search 
services. 


As a general guideline, use the fastest CPU possible and include as much RAM as possible. Although 
the duration of each user query is very short, while it is active it consumes an average of 500 KB of 
memory. Memory consumption varies widely while the indexer is calculating the final search results 
list, depending on the number of possible search results. 


Also, try to schedule the regeneration of your indexes during off-peak hours so that it won't interfere 
with normal user searches. (See Section 8.9, “Automating Index and Server Maintenance,” on 
page 96.) 


Making Good Use of Document Fields 


A document field is any meta tag or document summary field that helps to identify the document's 
contents. A document summary field might be a title, heading, or paragraph contained in a title or 
meta tag within an HTML document. 


QuickFinder is designed to take advantage of document fields in order to improve the accuracy, 
relevance, display information, and speed of search results. 


By design, QuickFinder always indexes all document fields in many document types, including 
HTML, PDF, Word, WordPerfect, XML, etc. Users can then constrain searches to the contents of any 
document field. 


As a QuickFinder administrator, you can also use document fields to further restrict search results to 
certain products, categories, authors, titles, keywords, or any other content belonging to a document 
field. 
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10.11 


To perform a field-restricted search, use the 'fieldname-search criteria search operator. 





TIP: You might consider sending this information as hidden data using the &filter= query parameter. 
For example: 


&filter=“*product=linux 





Searching XML Documents 


XML documents provide a tremendous advantage to narrowing search results because of their 
hierarchical structure and use of multiple document summary fields. 


QuickFinder provides complete hierarchical searching by using the fieldname=search_criteria 
operator. For example, you can find information anywhere in the XML document, within any of the 
title tags, or limit it to within the title tag that is part of the <DOCUMENT><SUMMARY> hierarchy. 


The following table shows example uses of the fieldname=search_criteria operator when performing a 
search in XML documents. 


Table 10-1 Example Uses of the fieldname=search_criteria Operator 


Example Values Result 
search_criteria Finds search_criteria anywhere in the document. 
ADocument*=search_criteria Finds search_criteria anywhere within any tag that is part of the 


<DOCUMENT> hierarchy. 


A<Document<Summary*=search_ Finds search_criteria within any tag that is part of the 

criteria <DOCUMENT> or <SUMMARY> hierarchy. 
A<Document<Summary<Title=search_ Finds search criteria only within the 

criteria <DOCUMENT><SUMMARY><TITLE> hierarchy. 
A<Document*<Title=search_criteria Finds search_criteria within any TITLE tag, located at any level 


within the <DOCUMENT> hierarchy. 


A<*<Title=search_criteria Finds search_criteria within any TITLE tag in the document. 


Using the &filter Query Parameter 


The &filter query parameter lets you enhance searches by adding hidden, additional query details 
when users submit a search query. This is an enhancement over previous versions of QuickFinder, 
which required you to use JavaScript to add additional details to search queries. 


The &filter query parameter works just like the &query= parameter, and they can be used together by 
using the optional number (#) value. For example, if the query parameter was 
&query0=search_criteria, the matching filter parameter would be 
&filterO=additional_hidden_search_criteria. This allows the multiple weighted queries feature to work 
as designed while allowing administrators to add additional query details to each query. 


Unlike the &query parameter, the &filter parameter can be sent multiple times. For example, if users 
search for software patches, you could include the various products to be searched, which could then 
improve search time and accuracy: 
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querv-software 
patchesfilter=*Products=Product257filter=*Products=Product16filter=*Products=Produ 
ct302 


The resultant URL might appear as follows, but with the HTTP and domain name prefix: 


&query=softwaretpatches&filter=s2FProducts%3DProduct257&filter=%2FProducts%3DProdu 
ct16£filter=%2FProducts$3DProduct302 





NOTE: All &filter operators are combined by using the default &operator=value, AND. Also, the 
default Boolean conjunction joining the various filter operators is an OR search. You can change the 
default Boolean conjunction by using the &filteroperator=# query parameter. The pound sign (f) here 
acts just like the one used in the #operator=# query parameter. 
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Understanding Templates 


QuickFinder Server uses templates to generate search forms and search and print results as well as 
user feedback such as error or response messages. 


A template is an HTML document containing one or more QuickFinder Server variables. Template 
variables are used to produce dynamic results when a user performs a search on the virtual search 
server you have defined. 


Templates can be shared across virtual search servers or each virtual search server can point to its 
own set of templates. 


This section describes how templates work and discusses the default QuickFinder Server templates 
that are included with QuickFinder. 

¢ Section 11.1, “How Templates Work,” on page 123 

+ Section 11.2, “Exploring the Default Search and Print Templates,” on page 125 

+ Section 11.3, “How Templates Use System Memory,” on page 127 

+ Section 11.4, “Working with Additional Languages,” on page 127 


11.1 How Templates Work 


As defined above, a template is an HTML document containing one or more QuickFinder Server 
variables. When users search your virtual search server, they use a Web browser to access the search 
form template. See Figure 11-1. 


The Search form template, SearchTemplate.html, is stored by default in /var/lib/qfsearch/ 
Templates. This path might be different if you chose to install QuickFinder in another directory. 
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Figure 11-1 The QuickFinder Form in a Web Browser 
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The QuickFinder form is used to capture user input, select available indexes, and return the results in 
either a search or print results template, which appears to the user in a dynamically updated HTML 
document. 


Search result templates display hits according to user selections on the search form. For more 
information about these search result templates, see “Search Page Templates” on page 126. 


There are search and print templates for several different languages. For information about creating 
templates for international languages, see Chapter 14, “Internationalizing Search Services,” on 
page 171. 


After a query is submitted and results are found, QuickFinder populates a results template with all 
relevant information for each search result. (See Figure 11-2.) 


124 OES 11 SP2: Novell QuickFinder Server 5.0 Administration Guide 


11.2 


Figure 11-2 A Search Results Page Produced by ResultList Template.html 
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You can also customize the search form to include additional parameters that allow you to offer more 
options to your users for more accurate searching. 


Exploring the Default Search and Print Templates 


QuickFinder Server includes several default templates used to create search forms and to format, 


display, and print search results for users. 


You can use the templates as they are or you can modify them to look and feel how you want them to. 
You can also create as many additional templates as you need or replace the default templates with 


your own templates. 


QuickFinder includes the following template categories: 


+ 


+ 


+ 


+ 


Section 11.2.1, “Search Page Templates,” on page 126 


Section 11.2.2, “Search Result Templates,” on page 126 


Section 11.2.3, “Print Result Templates,” on page 126 


Section 11.2.4, “Error and Response Message Templates,” on page 127 


The templates are stored in /var/lib/qfsearch/Templates. 
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11.2.1 Search Page Templates 


QuickFinder includes two search page templates that are used to generate a search page: 


Table 11-1 Search Page Templates 


Template Name Purpose 


SearchTemplate.html Lets users select a variety of options when performing searches. 
This is the default search template used by QuickFinder Server. 


SearchTemplate.Simple Similar to SearchTemplate. html, except that this template 
contains no dynamic indexes. 


11.2.2 Search Result Templates 


QuickFinder includes several ready-made result templates: 


Table 11-2 Search Results Templates 


Template Name Purpose 


ResultListTemplate.html Formats and organizes search results and offers additional 
sorting functions to the user. 


ResultListNoHitsTemplate.html Indicates when no hits are found during a search and offers 
users a chance to refine their search. 


ResultListTerseTemplate.html Similar to ResultListTemplate but returns less 
information, such as dates and titles only. 














ResultListVerboseTemplate.html Similar to ResultListTemplate, but returns more 
information, such as file date, time, and language. 
Additional sort options are also provided. 


11.2.3 Print Result Templates 


From the search results page, users have the option of printing all files matching their search or only 
those files displayed on the current search results page. When one of these options is selected, the 
print result templates are displayed: 


Table 11-3 Print Results Templates 


Template Name Purpose 


PrintResultTemplate.html Combines the full contents of each of the files in the print 
request into a single document, which is then displayed in 
the user's Web browser. A dynamic table of contents is also 
created. 


When the entire content is downloaded to the browser, the 
browser's print dialog box appears. 


PrintResultNoHitsTemplate.html Indicates when no documents are found during a print 
request. 
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11.2.4 Error and Response Message Templates 


QuickFinder Server includes error and response message templates that are returned when an error 
occurs or when information is needed from the user. 


The default response message template is returned to convey a specific message to the user such as 
“Printjob exceeds recommended size limits,” typically returned when a user attempts to print more 
content than the Web administrator has allowed. 


The error and response message templates are found at /var/lib/qfsearch/Templates/ 
ErrorMessageTemplate.html and ResponseMessageTemplate.html. 


11.3 How Templates Use System Memory 


Templates are cached in memory for quick rendering speed. Each template consumes approximately 
10 KB. 


Similarly to the virtual search server cache, templates remain cached in memory until a period of 
inactivity has elapsed. The template is then dynamically removed from memory until its next use. 
The first time a template is accessed, therefore, is normally the slowest. 


TIP: Too many templates in the template cache can consume a great deal of memory. Try to share 
templates across sites to minimize the impact on system memory resources. 





11,4 Working with Additional Languages 


QuickFinder includes each of the templates described above in each of several languages. Using 
standard encoding practices, you can internationalize your templates. 


Any changes made to the default templates should also be made to the language templates you use. 
For more information about creating a multilingual search solution, see Chapter 14, 
“Internationalizing Search Services,” on page 171. 
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Working with Template Variables and 
Search Parameters 


If vou have a basic understanding of HTML, vou can create an advanced search solution that vour 
users can use to perform complex searches. 


Building an advanced search solution involves the use of QuickFinder template variables and search 
parameters to create or customize QuickFinder templates, and to create or customize one or more 
search forms. 


This section contains the following topics: 


+ Section 12.1, “Guidelines for Using Variables,” on page 129 

+ Section 12.2, “Terminology Changes,” on page 130 

è Section 12.3, “Adding a Search Box to Your Corporate Web Site,” on page 130 
+ Section 12.4, “Global Template Variables,” on page 130 

è Section 12.5, “Search Page Variables,” on page 137 

è Section 12.6, “Search Result Variables,” on page 137 

+ Section 12.7, “Print Result Variables,” on page 140 

+ Section 12.8, “Highlighter Variables,” on page 142 

+ Section 12.9, “Error Message Variables,” on page 142 

+ Section 12.10, “Response Message Variables,” on page 143 

¢ Section 12.11, “Query Report Template Variables,” on page 144 


+ Section 12.12, “Search Parameters,” on page 157 


12.1 Guidelines for Using Variables 


Use the following guidelines when you are using variables to either customize the default templates 
or to create new templates: 


+ Case Sensitivity: All variables are case sensitive. Changing case in a variable causes 
QuickFinder to ignore the variable. 


+ Variable Formatting: All variables must be used exactly as they appear in the tables in this 
document. Variables always begin with two dollar signs ($$). 


+ Success of a Variable: The inclusion of a variable does not guarantee that information is 
returned after a search is performed. For example, using the $$Author variable might not return 
the name of a document's author if that information is not available in the meta tag of the 
document. 


+ Internationalizing Templates: If you want to internationalize your templates, you must create a 
template for each language you want to support in your search solution. For more information 
about languages, see Chapter 14, “Internationalizing Search Services,” on page 171. 
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12.2 


12.3 


12.4 


For more information about how to implement variables in a search or print template, or how to 
implement search parameters in an HTML document to create a search form, see Chapter 13, 
“Customizing Your Templates and Search Forms,” on page 167. 


Terminology Changes 


In prior versions of QuickFinder Server, the term “search site” was defined as a collection of one or 
more indexes and related configuration files. To avoid confusion with the term Web site, the term was 
changed wherever it appeared in the documentation and in the variables and parameters. A search 
site is now referred to as a “virtual search server.” 


New variables and parameters that parallel the term virtual search server have been added. They 
function identically to the previous variables and parameters, and the old variables and parameters 
can still be used. 


Similarly, the term “collection” has been changed to “index.” 


We recommend that you start using the newer variables and parameters in order to avoid confusion. 


Adding a Search Box to Your Corporate Web Site 


To add a basic search box to a Web page on your Web site, add the following code at the location on 
the page where you want the search box to appear: 


<form name="SearchForm” method="get" action="/gfsearch/SearchServlet”> 
<input type="text” name="query”> 
<input type="submit” value="Search” > 


</form> 


Global Template Variables 


Global template variables can be used in any of the QuickFinder templates. 
For more information about how to implement variables in a template, see Chapter 13, “Customizing 


Your Templates and Search Forms,” on page 167. 


Table 12-1 Global Template Variables 


Name Description 


$$Authenticated Indicates whether or not the user is authenticated by returning either a 
1 (True) or O (False). 


$$BeginAuthenticated Begins a section for a valid, logged-in user. If a user is authenticated, 
the text between the begin and end tags is processed and appears in 
the output. If a user is not authenticated, the text is removed from the 
search results page. To control the appearance of unauthenticated 
search results, see “$$BeginUnAuthenticated” on page 132. 


See also “$$EndAuthenticated” on page 132. 
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Name 


$$BeginBestBetIndexesLoop 


$$BestBetIndex[number] 


$$BestBetIndexesCount 


$$BestBetIndexesCurrent 


$$BestBetNum 


$$BestBetShow 


$$BeginExpandindexesLoop 


$$BeginFiltersLoop 


$$BeginIndexesLoop 


$$BeginLogin 


$$BeginLoop 


$$BeginNoLogin 


Description 


Begins a repeating section that lists best bet indexes used to produce 
the best bets search results list. This section is repeated for each best 
bet index. 


See also “$$EndBestBetIndexesLoop” on page 132. 


Names of the best bets indexes the user specified in the search query. 
If the optional number is not provided, the value of 
$$BestBetIndexesCurrent is used. 


See also “$$BeginBestBetIndexesLoop” on page 131. 
Number of best bets indexes associated with the user query. 
See also “$$BeginBestBetIndexesLoop” on page 131. 
Number of the current best bets index. 

See also “$$BeginBestBetIndexesLoop” on page 131. 

Total number of best bets results to display at a time. 


Returns True or False, depending on QuickFinder Server Manager's 
Search Settings page. To override the default, use the &bbshow= true 
| false query parameter. 


Begins a repeating section that shows the search expansion indexes 
used if the primary indexes do not find any search results. This 
section is repeated for each search expansion index. 


Begins a repetitive section that is processed for each filter parameter 
associated with the current query item. Multiple query items can be 
sent as part of a single query. See also “$$EndFiltersLoop” on 

page 132. 


Begins a repetitive section that is processed for each index the user 
specified in the search query. 


See also '$$EndIndexesLoop' on page 133 and 
“$$Querylndex[number]” on page 135. 


Begins a section of code used to define a login form that the user can 
use to log in. 


This section is processed only if the &login=true query parameter is 
included with the QuickFinder request. 


End of the header section. Beginning of the repeating body section. 
This section is repeatedly parsed until there are no further result items 
to process. 


See also “$$EndLoop” on page 133. 


Informs users that the current search form does not require a login. 
Tvpicallv, this section is followed by a login button that users can click 
to receive a login form, which comes from the $$BeginLogin variable. 


If no login query parameter is passed to the server, then everything 
between this variable and $$EndNoLogin is returned to the user. 


See also “$$EndNoLogin” on page 133. 
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Name 


$$BeginQueryLoop 


$$BeginReturnFieldsLoop 


$$BeginSortKeysLoop 


$$BeginUnAuthenticated 


$$Counter[variable_number, 
increment number) 


$$DefaultQueryEncoding 


$$EndAuthenticated 


$$EndBestBetIndexesLoop 


$$EndExpandindexesLoop 


$$EndFiltersLoop 


Description 


Begins a repetitive section that is processed for each query item 
associated with the current search query. See “$$NumQueryltems” on 
page 134 for more information. 


See also “$$EndQueryLoop” on page 133. 


Begins a repetitive section that is reprocessed for each return field the 
user specified in the search query. 


See also “$$QueryReturnField[number]” on page 135. 


Begins a repetitive section that is processed for each sort key the user 
specified in the search query. 


See also “$$EndSortKeysLoop” on page 133 and 
“S$SortKeysCurrent” on page 136. 


Begins a section for an unrecognized or logged-out user. Used in 
conjunction with $$EndUnAuthenticated. If a user is not recognized, 
the text between these two tags is processed and appears in the 
output. If the user is recognized as a valid, logged-in user, this text 
does not appear in the output. 


To control the appearance of authenticated search results, see 
“$$BeginAuthenticated” on page 130. 


Inserts the value of the specified variable_number counter into the 
search result page. All counters initialize to zero. The optional second 
parameter specifies the amount to increment or decrement the current 
value. A maximum of 10 counters is supported. 


For example: 
$$Counter[1] = insert value of counter #1 
$$Counter[1,1] = increment counter #1 by 1 and display the new value 


$$Counter[5,-3] = decrement counter #5 by 3 and display the new 
value 


Default encoding of the user query if not specified by using the 
&encoding= query parameter. 


Ends a section for a valid, logged-in user. 
See also “$$BeginAuthenticated” on page 130. 


Closes the $$BeginBestBetIndexesLoop, which lists the best bets 
indexes used to produce the best bets results list. 


See also “$$BeginBestBetIndexesLoop” on page 131. 


Ends the $$BeginExpandedindexesLoop section, which is used to get 
a list of search expansion indexes used by the current query. 


See also '$$BeginExpandindexesLoop' on page 131. 


Ends a repetitive section that is processed for each filter parameter 
associated with the current querv item. 


See also “$$BeginFiltersLoop” on page 131. 
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Name 


$$EndIndexesLoop 


$$EndLogin 


$$EndLoop 
$$EndNoLogin 


$$EndQueryLoop 


$$EndReturnFieldsLoop 


$$EndSortKeysLoop 


$$EndUnAuthenticated 


$$ExpandindexesCount 


$$ExpandIndexesCurrent 


$$FilterCount 


$$FilterCurrent 


$$FilterOperator 


$$FilterValue[number] 


$$HostURL 


Description 


Ends a repetitive section that is processed for each index the user 
specified in the search query. 


See also '$$BeginindexesLoop' on page 131 and 
“$$Querylndex[number]” on page 135. 


Closes the $$BeginLogin section, which is used to produce a login 
form. 


See also “$$BeginLogin” on page 131. 
End of the repeating body section. Beginning of the footer section. 


Closes the $$BeginNoLogin section, which is used to specify that the 
user is not currently logged in. This section appears when no login 
parameter is passed to the server. 


See also “$$BeginNoLogin” on page 131. 


Ends a repetitive section that is processed for each query item 
associated with the current search query. See “$$NumQueryltems” on 
page 134 for more information. 


See also “$$BeginQueryLoop” on page 132. 


End of a repetitive section that is reprocessed for each return field the 
user specified in the search query. 


See also “$$QueryReturnField[number]” on page 135. 


Ends a repetitive section that is processed for each sort key the user 
specified in the search query. 


See also '$$BeginSortKevsLoop' on page 132 and 
“$S$SortKeysCurrent” on page 136. 


Ends a section for an unrecognized or logged-out user. For more 
information, see “$$BeginUnAuthenticated” on page 132. 


Number of search expansion indexes associated with the user query. 
See also '$$BeginExpandindexesLoop' on page 131. 

Number of the current search expansion index. 

See also '$$BeginExpandindexesLoop' on page 131. 


Number of filters associated with the current querv item. Multiple 
querv items can be associated with a single querv. 


Number of the current filter associated with the current querv item. 


Boolean operator used to join the filters associated with the current 
querv item. The full set of filters is alwavs joined to the current querv 
item using the Boolean AND. 


Pulls the value of the specified filter associated with the current query 
item. If the optional + parameter is not provided, the current filter loop 
value ($$FilterCurrent) is used. 


Generates the current URL up to, and including, the optional port 
number. 
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Name 


$$IncludeFile[template_name] 


$$IndexesCount 


$$IndexesCurrent 


$$lsInvalidLogin[text] 


$$NumQueryltems 


$$Query[number] 


$$QueryCount 


$$QueryCountry 


$$QueryCurrent 


$$QueryDate 


$$QueryEncoding 


$$QueryExpandIindex[number] 


$$QueryFileFilter 


Description 


Automatically pulls in the designated template at the location of this 
variable. The included template can contain other template variables, 
which are processed as though they were a part of the original 
template. The template name parameter can be either a full FILE:// 
URL based on the file system of the server or a relative path based on 
the location of the parent template. The template name parameter can 
be located within quotation marks. See the 
ResultListTemplate.html file for an example use of this 
variable. 


Number of indexes associated with the user query. 
See also '$$BeginindexesLoop' on page 131. 
Number of the current index. 

See also '$$BeginindexesLoop' on page 131. 


If a user's login is invalid, the text contained between the brackets is 
returned to the user. A typical message might be Invalid login. 
Please try again. 


Number of query items contained within the current query. Although 
most queries use only one query item, it is possible to construct a 
query with multiple search criteria, each weighted with a value 
between 1 and 100. The resulting search contains hits from each of 
the queries, but the search results are organized with the most 
relevant hits first (from any of the individual queries). 


Query specified by the client in the search field. The optional number 
identifies the corresponding query item. The value of $$QueryCurrent 
is used if the optional number is not provided. 


See also “$$NumQueryltems” on page 134 for more information. 
Number of query items associated with the search query. 
See also “$$NumQueryltems” on page 134. 


The country requested by the client. This must be an uppercase, two- 
character value as specified in ISO 3166-1. 


Number of the current query item. See “$$NumQueryltems” on 
page 134 for more information. 


See also “$$BeginQueryLoop” on page 132. 


Begin date requested by the client. Only those documents dated on or 
after the specified date are returned in the search results. See the 
query parameter “date” on page 159 for more information. 


Actual encoding used to interpret the query. This can be the same as 
the $$DefaultQueryEncoding, the value of the £encoding= query 
parameter, or UTF-8. 


Names of the search expansion indexes the user specified in the 
search query. If the optional number is not provided, the current value 
of $$ExpandindexesCurrent is used. 


See also “$$BeginExpandindexesLoop” on page 131. 


Returns the filename filter associated with the user query. 
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Name 


$SQuervindexjnumber) 


$$QueryLanguage 


$$QueryNumHits 


$$QueryOperator 


$$QueryReturnField[number] 


$$QueryServerNameltext] 


$$QuerySynonymFlag 


$$QueryTemplate 


$$QueryTemplateTheme 


$$QueryVersion 
$$QueryWeight[number] 


Description 


Names of the indexes the user specified in the search query. If the 
optional number is not provided, the current value of 
$$IndexesCurrent is used. 


See also '$$BeginindexesLoop' on page 131. 


Language requested by the client. This must be a lowercase, two- 
character value as specified in ISO 639. 


Number of search results requested by the client. 
The type of the current search: 


O = Boolean AND search 
1 = Boolean OR search 
2 = phrase search 


Name of the return fields the user specified in the search query. If the 
optional number is not provided, the current value of 
$$ReturnFieldsCurrent is used. 


See also “$$BeginReturnFieldsLoop” on page 132 and 
“$$EndReturnFieldsLoop” on page 133. 


Identifies the name of the Virtual Search Server provided with the 
&server= query parameter. The optional text parameter can be 
provided in the following formats: 


$$QueryServerName = NameOfServer 
$$QueryServerNameltext] = text NameOfServer 
$$QueryServerName[Vtext] = text URLEncodedNameOfServer 


$$QueryServerNameltext $$QueryServerName text] = 
text NameOfServer text 


$$QueryServerName[Vtext $$QueryServerName text] = 
text URLEncodedNameOfServer text 


See also '$$ServerName' on page 136. 


Set to either True or False based on the current setting on 
QuickFinder Server Manager’s General Settings page. See “Using 
Synonyms to Broaden Search Results” on page 114 for information 
about enabling synonym-enhanced searching. 


Template name requested by the client. 
See also “S$TemplateName” on page 136. 


Template theme requested by the client. This is not necessarily the 
theme of the search result because the specified theme might not 
exist. 


See also “$$TemplateTheme” on page 136. 
Version number of the current query format. 


Weighting of the current query item, 1 to 100. If number is not 
specified, the value of $$QueryCurrent is used. See 
“$$NumQueryltems” on page 134 for more information. 
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Name 


$$ResultEncoding 


$$ReturnField[number] 


$$ReturnFieldsCount 


$$ReturnFieldsCurrent 


$$SearchFor[number] 


$$ServerName 


$$ServerLocation 


$$SortField[number] 


$$SortKeysCount 


$$SortKeysCurrent 


$$SortOrder[number] 


$$TemplateExt 


$$TemplateLocale 


$$TemplateName 


$$TemplateTheme 


$$UserlD 


Description 


Encoding used to return the current search results page. This is either 
the value of the valid &retencoding=query parameter or the default 
specified by the search administrator in the QuickFinder Server 
Manager. 


Name of the return fields the user specified in the search query. If the 
optional number is not provided, the value of $$ReturnFieldsCurrent 
is used. 


See also “$$BeginReturnFieldsLoop” on page 132 and 
“$$EndReturnFieldsLoop” on page 133. 


Number of return fields specified in the search query. 
See also “$$BeginReturnFieldsLoop” on page 132. 
Number of the current iteration of the $$BeginReturnFieldsLoop. 


Query entered by the client into the search field. If the optional 
number is not provided, the value of $$QueryCurrent is used. See 
“$$Query[number]” on page 134 for more information. 


Name of the virtual search server that produced the current output. 
See also “$$QueryServerNameltext]” on page 135. 


Path on the network server to the virtual search server configuration 
files and indexes. 


The name of the field to sort on. If the optional number is not provided, 
the value of $$SortKeysCurrent is used. See 
“$$SortByURL[sortfield.sortorder ...]” on page 140 and the query 
parameter “sortorderquery_number” on page 164 for more 
information. 


Number of sort keys associated with the current query. 


Current sort keys number. See “$$BeginSortKeysLoop” on page 132 
for more information. 


Method of sorting the field (ascending, descending, and default). If the 
optional number is not provided, the value of $$SortKeysCurrent is 
used. See “$$SortOrder[number]” on page 136 for more Information. 


Filename extension of the template currently displayed in the browser. 


When an error occurs, QuickFinder automatically attempts to find an 
error message template that matches the filename extension of the 
requested search template. 


Locale of the template, such as zh TW. The locale information is 
taken from the template filename. 


Filename of the template currently displayed in the browser. 
See also '$$QuervTemplate' on page 135. 

Theme (or theme directory) that the current template belongs to. 
See also '$$QuervTemplateTheme' on page 135. 


The User ID corresponding to the user who is currently logged in. 
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12.5 


12.6 


Search Page Variables 


The following table lists all available search page variables that can be used in addition to the global 
template variables to extend the functionality of the default search templates (searchTemplate. html 
Of SearchTemplate. Simple) or to create new templates. 


Table 12-2 Search Page Variables 


Name 


$$BeginServerlndexesLoop 


$$EndServerlndexesLoop 


$$ServerlndexDescription 


$$ServerlndexName 


Description 


Begins a repeating section in the search template where information for 
each of the defined indexes is written. 


Ends a repeating section in the search template where information for 
each of the defined indexes is written. 


Description of the virtual search server defined in the QuickFinder Server 
Manager. 


Name of the virtual search server defined in the QuickFinder Server 
Manager. 


Search Result Variables 


The following table lists all available search result variables that can be used in addition to the global 
template variables to extend the functionality of the default search result templates or to create new 


templates. 


For more information about how to customize templates, see Chapter 11, “Understanding 


Templates,” on page 123 and Chapter 13, “Customizing Your Templates and Search Forms,” on 


page 167. 


Table 12-3 Search Result Variables 


Variable Name 


$$Author 


$$BeginAuthorized 


$$BeginBestBet 


Description 


Name of the original author of a document returned in a hit. 


Begins a section for a search result that the user has rights to see. 
Used in conjunction with $$EndAuthorized. If a search result is 
authorized, this section of text and template variables is processed. If 
it is unauthorized, this section is removed from the output. 


See also “$$BeginUnAuthorized” on page 138. 


Begins a repetitive section that is processed for each best bet search 
result item. 


Result detail variables, such as $$Title, $$Description, $$lndex, and 
$$Relevance, can be used within this section. 


See also “$$EndBestBet” on page 138. 
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Variable Name 


$$BeginUnAuthorized 


$$DateTime[date_format] 


$$Description 
$$Encoding 
$$EndAuthorized 


$$EndBestBet 


$$EndUnAuthorized 


$$FileFormat 


$$FirstHit 


$$HighlightURL [text] 


$$Index 


$$IsExpandedSearch|text] 


$$Language 


Description 


Begins a section for a search result that the user does not have rights 
to see. Used in conjunction with $$EndUnAuthorized. If a search 
result is not authorized, this section of text and template variables is 
processed. If the search result is authorized, this section is removed 
from the output. 


See also “$$BeginAuthorized” on page 137. 


The date and time of a hit. This is automatically written in the Java 
“medium” date format using the client's locale (all calendars, 
translations, and date and time formats are observed). 


$$DateTime[ ] can use an optional date and time format provided 
within the brackets ( ]. The text should conform to the Java 
DateFormat syntax. 


Abstract, description, or first 255 display bytes of the result item. 
Character set encoding of the current search result item. 


Ends a section for a search result that the user has rights to see. For 
more information, see “$$BeginAuthorized” on page 137. 


Ends the $$BeginBestBet section, which is used to display best bets 
results. See “$$BeginBestBet” on page 137. 


Ends a section for a search result item that the user does not have 
rights to see. For more information, see “$$BeginUnAuthorized” on 
page 138. 


Indicates a specific document type. For example, HTML, Word 97, or 
PowerPoint. 


TIP: You can control the text output for each file format by using the 
optional FileFormats.properties file. For more information, see 
the Novell QuickFinder Server File Formats (http://www.novell.com/ 
products/quickfinder/fileformats.html) page. 


Hit number of the first item in the current result page. Displayed using 
the client's locale. 


If the source document of a search result is capable of being 
highlighted (HTML or text files), then the text contained within the 
brackets is displayed. This variable can be used as a marker to 
identify which of the search results can display highlighted search 
terms. Typically, $$HighlightURL is also included within the brackets 
and thereby outputs the URL to be used to highlight the current 
document. 


Name of the index in which a particular search result item was found. 


Displays a message indicating when a set of results was produced 
from expanded search indexes. The message is placed between the 
brackets [ ] and might read something like The query you were 
looking for was not found in the selected indexes. 
The displayed search results were produced from 
additional search indexes. 


Language of the result item. $$Language is displayed in the language 
of the client's locale. 
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Variable Name 


$$LastHit 


$$MoredHits[page#, text] 


$$MoreHitsURLIpage number) 


$$Number 


$$PageNum[page#] 


$$PrintURL[first_hit_number, 
number_of_hits] 


$$Relevance 


$$SearchFor[number] 


$$SearchTime 


$$Size 


Description 


Hit number of the last item in the current result page. Displayed using 
the client’s locale. 


Conditional text section to be included only if there are additional hits 
in the search results that can be retrieved. 


If the first section of the conditional text contains a number followed by 
a comma (for example: $$MoreHits[3, text to be included]), the server 
first determines if the designated search results page exists. If page# 
is missing, 1 (the next page) is assumed. If the designated page is 
available, the remaining text after the comma and up to the closing 
bracket is written to the result page. 


The initial number is relative to the current page. That is, -1 
references the page immediately before the current page and 1 
references the page immediately after. Zero (0) refers to the current 
page. 


URL needed to display another page of search results. The optional 
parameter identifies the desired search result page number. If it is not 
provided, 1 is assumed. The page number is relative to the current 
page. That is, -1 refers to the page immediately before the current 
page and 1 references the page immediately after. Zero (0) refers to 
the current page. 


The URL is inserted only if the designated page exists. 


Hit number of the current result item. Possible numbers begin with 1 
and end with $$TotalHits. Displayed using the client’s locale. 


Page number corresponding to the current search results page. This 
variable is used when more search results are available than can fit on 
one page (such as when $$TotalHits is greater than the number of hits 
specified per page in the &numhits=# query parameter). 


The optional page# identifies the relative page from the current result 
page. That is, -1 refers to the page immediately before the current 
page and 1 references the page immediately after. Zero (0) refers to 
the current page. 


The page number is inserted only if the designated page exists. 
URL used to print the hits listed on the current search result page. 


The optional parameters can be specified to define the beginning 
search result number and the number of search results to include in 
the print job. 


The number_of_hits parameter can use the $$TotalHits template 
variable. 


How closely the result matches the user’s query, indicated by 
percentages (1% to 100%). 


Query entered by the client into the search field. See 
“$$Query[number]” on page 134 for more information. 


Amount of time used to process the current search request. 
$$SearchTime is displayed using the client’s locale. 


Size of the data pointed to by the result item’s URL. Displayed using 
the client’s locale. 


Working with Template Variables and Search Parameters 


139 


Variable Name Description 


$$SortByDate Returns True or False depending on the &sortbydate=true_false query 
parameter. 


$$SortByURL[sortfield.sortorder The URL used to show the current result page sorted by one or more 
—4 search result fields. 


Sort field names include title, author, changedate, filelength, 
language, summary, relevance, url, index, format, and 
document number. 


Optional sort orders include ascending and descending. 
Sort field and sort order names are separated by a period. 
Multiple sort fields are separated by a space. 


$$Title If a title is not available in documents being searched, $$URL is used 
instead; if the URL is unavailable, < title unavailable > is used. 


$$TotalHits Total number of hits that match the search query. This is not the same 
as the number of hits displayed in any particular result page. 
Displayed using the client’s locale. 


$$URL URL of the result item. 


12.7 Print Result Variables 


The following table lists all available print result variables that can be used in addition to the global 
template variables to extend the functionality of the default print result templates or to create new 
templates. 


For more information about how to implement variables in a template (HTML) page, see Chapter 13, 
“Customizing Your Templates and Search Forms,” on page 167. 


Table 12-4 Print Result Variables 


Name Description 


$$BeginAuthorized Begins a section for a print result that the user has rights to see. Used in 
conjunction with $$EndAuthorized. If a search result is authorized, this 
section of text and template variables is processed. If the result is 
unauthorized, this section is removed from the output. 


See also “$$BeginUnAuthorized” on page 138. 


$$BeginMimeType[text/ Identifies special formatting to apply to individual print result items based on 
plain] their Mime type. For example, text formats should generally be output by 
using HTML’s <pre> tag, such as in the following: 


SSBeginMimeTvpe [text/plain] 
<pre> 
$SEndMimeType 


See also “$$EndMimeType” on page 141. 
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Name 


$$BeginTOCList[text] 


$$BeginUnAuthorized 


$$Bookmark 


$$Description 
$$EndAuthorized 


$$EndMimeType 


$$ENdTOCList[text] 


$$EndUnAuthorized 


$$Number 


$$Numindents 


$$Product 


$$Title 


$$TotalHits 


$$URL 


Description 


Beginning of the table of contents repeating section. This section is 
repeatedly parsed until there are no further TOC result items to process. 


This is a conditional text section. The items within the brackets ( [ ] ) are 
processed only if the current item represents a change in the depth of the 
hierarchy. If $$Product appears within the conditional text, itis replaced only 
if the current item also represents a new product. 


Begins a section for a print result that the user does not have rights to see. 
Used in conjunction with $$EndUnAuthorized. If a print result is not 
authorized, this section of text and template variables is processed. If the 
print result is authorized, this section is removed from the output. 


See also “$$BeginAuthorized” on page 137. 


HTML anchor name of the current result item. This can be used to jump 
from a TOC entry to the corresponding section within the print job. All 
bookmark entries begin with “novell_print_toc_” and are followed by the 
number of the current result item, as in novell_print_toc_1. 


Abstract, description, or first 255 display bytes of the result item. 


Ends a section for a print result that the user has rights to see. For more 
information, see '$$BeginAuthorized' on page 137. 


Ends a $$BeginMimeType section. For more information, see 
“S$BeginMimeTypeltext/plain]” on page 140. 


End of the table of contents section. 


This is a conditional text section. The items within the brackets ( [ ] ) are 
written out each time a result item occurs that decreases the depth of the 
hierarchy. If the depth of the current item is several levels fewer than the 
previous item, the text within the conditional text block is written out that 
many times. 


Ends a section for a print result item that the user does not have rights to 
see. For more information, see “$$BeginUnAuthorized” on page 138. 


Hit number of the current result item. Possible numbers begin with 1 and 
end with $$TotalHits. Is displayed using the client's locale. 


Number of indentations required for the current Table of Contents entry. 


Name of the product associated with the current item in the table of 
contents. 


This displays only if this is the first result item within that product. 
See also “$$BeginTOCList[text]” on page 141. 


Title of the result item. For empty titles, <title unavailable> is displayed. 
Displayed using the client's locale. 


Total number of hits that match the search query. This is not the same as 
the number of hits displayed in any particular result page. Displayed using 
the client's locale. 


URL of the result item. 
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Name Description 


$$URLContent The entire contents of the URL are placed into the template at this location. 
The URL contents are not parsed to validate their data type, formatting, or 
functionality. Only text/plain and text/html files are printed. All other files are 
inserted into the print job as an error message. 


12.8 Highlighter Variables 


The following table lists all available highlighter variables that can be used in addition to the global 
template variables to extend the functionality of the default highlighter template or to create a new 
template. 


For more information about how to implement variables in a template, see Chapter 13, “Customizing 
Your Templates and Search Forms,” on page 167. 


Table 12-5 Highlighter Variables 


Name Description 
$$BeginMetaDataLoop Begins a loop used for formatting the meta tags associated with the currently 


highlighted file. For example, if three meta tags were found, this loop could 
produce three rows in a table, placing the data from one meta tag in each of 
the three rows. 


See also “$$MetaName” on page 142 and “S$MetaValue” on page 142. 


$$BeginWordsLoop Begins a loop that outputs the search terms used to find the current 
document. Each search term is produced using the colors specified in 
QuickFinder Server Manager. 


See also “$$Word” on page 142. 


$$EndMetaDataLoop Ends the $$BeginMetaDataLoop section. 

$$EndWordsLoop Ends the $$BeginWordsLoop section. 

$$MetaName Name of the metadata tag, such as Title or Description. 

$$MetaValue Lists the values of each of the metadata tags found in a file. 

$$Word Lists all of the words to be highlighted. The words are produced using the 


colors specified in QuickFinder Server Manager. 


See the HighlighterTemplate.html file for an example. 


12.9 Error Message Variables 


The following table lists all available error message variables that can be used in addition to the 
global template variables to enhance the organization of the default error message template, or to 
create new templates. 


For more information about how to implement variables in a template, see Chapter 13, “Customizing 
Your Templates and Search Forms,” on page 167. 
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12.10 


Table 12-6 Error Message Variables 


Name 


$$ErrorDescription 


$$ErrorMessage 


$$ErrorNumber 


Description 


Longer version of the message. This might include additional error details or 
problem resolution information. 


Text version of the error. Generally quite short. 


Numeric version of the error. 


Response Message Variables 


The following table lists all available response message variables that can be used in addition to the 
global template variables to enhance the organization of the default response message templates or to 


create new templates. 


For more information about how to implement variables in a template, see Chapter 13, “Customizing 
Your Templates and Search Forms,” on page 167. 





NOTE: The repeating variables $$BeginLoop and $$EndLoop should not be used in a response 


message and are ignored if used. 





Table 12-7 Response Message Variables 


Name 


$$Cancel[text] 


$$Continue[text] 


$$Help[text] 


$$lgnore[text] 


$$Next|text] 


$$No[text] 


$$OK [text] 


$$Prev[text] 


$$ResponseNumber 


$$ResponseMessage 


Description 


If the Cancel button is specified by Server logic, this parses and inserts the 
conditional text into the response page. Currently used by PrintServlet when 
a print job exceeds the print job size warning limit. 


If the Continue button is specified by Server logic, this parses and inserts the 
conditional text into the response page. Currently used by PrintServlet when 
a print job exceeds the print job size warning limit. 


If the Next button is specified by Server logic, this parses and inserts the 
conditional text into the response page. 


If the Ignore button is specified by Server logic, this parses and inserts the 
conditional text into the response page. 


Compare to $$Prev. 


If the No button is specified by Server logic, this parses and inserts the 
conditional text into the response page. 


If the OK button is specified by Server logic, this parses and inserts the 
conditional text into the response page. Currently used by PrintServlet when 
a print job exceeds the maximum print job size. 


If the Previous button is specified by Server logic, this parses and inserts the 
conditional text into the response page. 


Numeric version of the response required of the user. 


Text version of the response required of the user. Generally quite terse. Can 
often be used as a title. 
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Name Description 


$$ResponseDescription Longer version of the message. This might include additional details or “see 
also” information. 


$$Retry[text] If the Retry button is specified by server logic, this parses and inserts the 
conditional text into the response page. 

$$URL URL to use when the Parent button is clicked. This must appear within the 
brackets of a button’s conditional text section. The URL logic is generated by 
the server. 

$$Yes[text] If the Yes button is specified by server logic, this parses and inserts the 


conditional text into the response page. 


12,11 Query Report Template Variables 


The following tables list all available query report template variables that can be used in addition to 
the global template variables to extend the functionality of the default query report templates or to 
create new templates. 


All numbers, dates, times, and day names throughout the report use either the locale of the template 
or server to properly display this information according to the rules defined by each language and 
country. 

¢ Section 12.11.1, “General,” on page 145 

¢ Section 12.11.2, “Report Summary,” on page 145 

+ Section 12.11.3, “Templates Used,” on page 145 

+ Section 12.11.4, “Load Details,” on page 146 

+ Section 12.11.5, “Search Details,” on page 149 

+ Section 12.11.6, “Search Results Pages,” on page 150 

¢ Section 12.11.7, “Top X Queries,” on page 150 

¢ Section 12.11.8, “Top Queries,” on page 151 

+ Section 12.11.9, “Error Searches,” on page 152 

è Section 12.11.10, “Not Found Searches,” on page 153 

+ Section 12.11.11, “Redirected Searches,” on page 154 

¢ Section 12.11.12, “Login Requests,” on page 154 

+ Section 12.11.13, “Print Details,” on page 154 

¢ Section 12.11.14, “Print Errors,” on page 155 

¢ Section 12.11.15, “Highlight Details,” on page 156 

+ Section 12.11.16, “Export Details,” on page 156 
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12.11.1 


12.11.2 


12.11.3 


General 


Table 12-8 General Query Report Template Variables 


Name 


$$ReportName 


$$SiteName 


Report Summary 


Description 


Displays the filename of the current report without the terminating filename 
extension. A query report’s filename usually corresponds to the date range 
represented within the report. 


The name of the virtual search server to which the query report belongs. 


Table 12-9 Report Summary Query Report Template Variables 


Name 


$$Access Total 


$$UniqueUsers 


Templates Used 


Description 


Displays the total number of requests received during the current report 
period. 


Displays the number of unique users that were successfully authenticated 
through QuickFinder. 


Table 12-10 Templates Used Query Report Template Variables 


Name 


$$BeginRptTemplatesLoop 


$$EndRptTemplatesLoop 


$$RptTemplate 
$$RptTemplate Total 
$$RptTemplateCurrent 


$$RptTemplateCount 


Description 


Begins a repeating section that displays the list of templates used to 
return search results information to the end user. This includes all 
template types. 


Ends a repeating section that displays the list of templates used to return 
search results information to the end user. This includes all template 


types. 


The name of the current QuickFinder template. 
The number of times the current template was used. 
The number of the current loop. 1-based. 


The total number of unique templates requested by all users during the 
logging period. 
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12.11.4 Load Details 


Table 12-11 Load Details Query Report Template Variables 


Name 


$$DayOfWeek[#] 


By Week 
$$BeginChartWeek[#] 


$$EndChartWeek 


$$BeginChartWeekDay[#2] or [#1,#2] 


$$EndChartWeekDay 


$$BeginSkiplfEmptyDay[#2] or [#1,#2] 


$$EndSkiplfEmptyDay 


$$WeekDayTotal[#2] or [#1,#2] 


Description 


Displays the name of the current day of the week. # - 
optional day of week number (1 - 7) 


Begins a repeating section that displays a load chart for the 
specified week. # - optional week value (1 - 6). If the 
optional week value is provided, but the week has no load 
information, this entire section is skipped. If the optional 
week value is not provided and the “current” week has no 
load information, the section is skipped for the current 
week, but repeated for any remaining weeks that follow. 


Ends a repeating section that displays a load chart for the 
specified week. 


Begins a repeating section that displays information for 
each day of the week. If the specified day and week do not 
have load information available, the current section is not 
skipped. Use $$BeginSkiplfEmptyDay to skip the current 
section. 


#1 - optional week value (1 - 6). 
#2 - optional day value (1 - 7) 


Ends a repeating section that displays information for each 
day of the week. 


Skips the current section (up to $$EndSkiplfEmptyDay) if 
the specified day of the week does not have any load 
information available. 


#1 - optional week value (1 - 6); defaults to the current value 
of the $$BeginChartWeek loop. 


#2 - optional day value (1 - 7); defaults to the current value 
of $$BeginChartWeekDay loop. 


Ends the current section if the specified day of the week 
does not have any load information available. 


Displays the total number of requests handled on the 
specified day and week. 


#1 - optional week value (1 - 6); defaults to the current value 
of the $$BeginChartWeek loop. 


#2 - optional day value (1 - 7); defaults to the current value 
of $$BeginChartWeekDay loop. 
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Name 


$$WeekDayPeek[#2] or [#1,#2] 


$$WeekDayPeekTime[#2] or [#1,#2] 


$$ChartWeekDay[#3] or [#3,#4] or 
[#2,#3,#4] or [#1,#2,#3,#4] 


$$CurrentChartWeek 


$$WeekDateRange 


By Day of Week 


$$BeginChartDayAverages|#] 


$$EndChartDayAverages 


$$BeginChartHour[#2] or [#1,#2] 


$$EndChartHour 


Description 


Displays the peak number of requests handled in a single 
hour on the specified day and week. 


#1 - optional week value (1 - 6); defaults to the current value 
of the $$BeginChartWeek loop. 


#2 - optional day value (1 - 7); defaults to the current value 
of $$BeginChartWeekDay loop. 


Displays the time of day when the peak number of requests 
occurred for the specified day and week. 


#1 - optional week value (1 - 6); defaults to the current value 
of the $$BeginChartWeek loop. 


#2 - optional day value (1 - 7); defaults to the current value 
of the $$BeginChartWeekDay loop. 


Displays a chart showing the relative number of requests 
received on the specified day and week. The chart is 
produced using a single character (#4) repeated #3 times. 


#1 - optional week (1 - 6); defaults to $$BeginChartWeek. 


#2 - optional day value (1 - 7); defaults to 
$$BeginChartWeekDay. 


#3 - optional repeat value; defaults to 100. 
#4 - optional character; defaults to capital | 
Displays the number of the current week (1 - 6). 


Displays the date range represented by the current week. 
Dates are displayed using the Java “medium” date format. 


Begins a repeating section that displays a load chart for the 
specified day of week. # - optional day of week value (1 - 7). 
If the optional day of week value is provided, but the day 
has no load information, this entire section is skipped. If the 
optional day of week value is not provided and the “current” 
day has no load information, the section is skipped for the 
current day of week, but repeated for any remaining days 
that follow. 


Ends a repeating section that displays a load chart for the 
specified day of week. 


Begins a repeating section that displays information for 
each hour of the current day of week. If the specified hour 
and day do not have load information available, the current 
section is not skipped. Use $$BeginSkipIfEmptyHour to skip 
the current section. 


#1 - optional day value (1 - 7). 
#2 - optional hour value (1 - 24). 


Ends a repeating section that displays information for each 
hour of the current day of week. 
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Name Description 


$$lsAverageDay[averageText, actualText] Displays either averageText or actualText based on the 
number of days represented by the current day of week. 


$$BeginSkiplfEmptyHour[#2] or [#1,#2] Skips the current section (up to $$EndSkiplfEmptyHour) if 
the specified hour does not have any load information 
available. 


#1 - optional day of week value (1 - 7); defaults to the 
current value of the $$BeginChartDayAverages loop. 


#2 - optional hour value (1 - 24); defaults to the current 
value of the $$BeginChartHour loop. 


$$EndSkiplfEmptyHour Ends the current section if the specified hour does not have 
any load information available. 

$$CurrentChartHour Displays the time of day corresponding to the current hour. 

$$HourTotal[#2] or [#1,#2] Displays the average number of requests handled during 


the specified hour and day. 


#1 - optional day of week value (1 - 7); defaults to the 
current value of the $$BeginChartDayAverages loop. 


#2 - optional hour value (1 - 24); defaults to the current 
value of the $$BeginChartHour loop. 


$$HourPeek[#2] or [#1,#2] Displays the peak number of requests handled during the 
specified hour. This # matches $$HourTotal if only 1 day is 
represented for the day of week. 


#1 - optional day of week value (1 - 7); defaults to the 
current value of the $$BeginChartDayAverages loop. 


#2 - optional hour value (1 - 24); defaults to the current 
value of the $$BeginChartHour loop. 


$$HourPeekTime[#2] or [#1,#2] Displays the time of day when the peak number of requests 
occurred for the specified hour and day of week. 


#1 - optional day of week value (1 - 7); defaults to current 
value of $$BeginChartDayAverages loop. 


#2 - optional hour value (1 - 24); defaults to current value of 
$$BeginChartHour loop. 


$$ChartHour[#3] or [#3,#4] or [#2,43,#4] or Displays a chart showing the relative number of requests 

[#1,#2,43,#4] received on the specified hour and day of week. The chart 
is produced by using a single character (#4) repeated #3 
times. 


#1 - optional day of week (1 - 7); defaults to 
$$BeginChartDayAverages. 


#2 - optional hour value (1 - 24); defaults to 
$$BeginChartHour. 


#3 - optional repeat value; defaults to 100. 


#4 - optional character; defaults to capital | 
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12.11.5 


Search Details 


Table 12-12 Search Details Query Report Template Variables 


Name 


$$QueryTotal 


$$SuccessfulQueries 


$$NotFoundQueries 


$$ErrorQueries 


$$ExpandedQueries 


$$RedirectedQueries 


$$ShowFirstQueries 


$$SearchPageQueries 


$$LoginQueries 


$$LogoutQueries 


$$SwitchProtocolQueries 


$$AvgNumHitsPerPage 


$$AvgTotalNumHits 


$$AvgQueryTime 


Description 


Displays the total number of search requests received by QuickFinder. 
This includes all types of search, including failed searches. 


Displays the total number of regular search requests that were 
successfully completed. 


Displays the total number of search requests that could not find any hits. 
This includes the searches that were successfully completed by looking 
in other indexes using the Search Expansion feature. See 
“$$ExpandedQueries” on page 149 for more information. 


Displays the total number of search requests that resulted in an error 
condition. Errors can arise if the server is currently unable to complete 
the request, the request is too complex or takes too long to process, the 
query syntax is incorrect, the server load is too great, or because of a 
number of hardware-related or software-related issues that can prevent a 
search from processing properly. 


Displays the total number of “Not Found” search requests that were 
successfully completed by looking in other indexes as a result of the 
Search Expansion feature. 


Displays the total number of search requests that were redirected to a 
specific, admin-defined URL. 


Displays the total number of search requests that resulted in a successful 
search, but were redirected to the first hit in the search results list. 


Displays the total number of search requests that resulted in showing the 
Advanced Search page to the end user. 


Displays the total number of search requests that represent an attempt by 
the search user to log in. 


Displays the total number of search requests that represent an attempt by 
the search user to log out. 


Displays the total number of search requests that result in a switch of 
protocols. If specified by the administrator, QuickFinder can redirect login 
attempts from the unsecured HTTP protocol to the more secure HTTPS. 


Displays the average number of hits listed on a single search results 
page. 


Displays the average total number of hits for user queries. 


Displays the average amount of time required to complete user queries. 
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12.11.6 


Search Results Pages 


Table 12-13 Search Results Pages Query Report Template Variables 


Name 


$$BeginResultPageLoop[+*] 


$$EndResultPageLoop 


$$ResultPageNum 


$$ResultPageTotal 


$$ResultPageCount 


$$ResultTotalPages 


$$ResultPagePercentage 


$$ResultPageCurrent 
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Description 


Begins a repeating section that displays information regarding the search 
results page on which users found their information. # - optional page 
number to begin the loop. 1-based. The loop terminates as soon as a 
search results page returns a use percentage less than 1%. 


Ends a repeating section that displays information regarding the search 
results page on which users found their information. 


The number of the current search result page. 1-based. 


The total number of times user found their hit on the current search 
results page. 


The maximum search results page number includes all of the <1% search 
results pages. 


The maximum search results page number includes all of the <1% search 
results pages. 


Percent of users who found a hit on the current search results page. 


The number of the current loop; see the optional # in 
$$BeginResultPageLoop. 1-based. 


Table 12-14 Top X Queries Query Report Template Variables 


Name 


$$BeginTopQueriesLoop|#] 


$$EndTopQueriesLoop 
$$TopQuery 
$$TopSubQuery 
$$TopFilterQuery 
$$TopFileFilterQuery 


$$TopQueryTotal 


$$TopQuerySubTotal 


$$TopQueryCurrent 


$$TopQueryCount 


Description 


Begins a repeating section that displays the most popular user searches. 
The loop is repeated for the top number of queries. The optional number 
defaults to 100 if not provided. 


Ends a repeating section that displays the most popular user searches. 
The current most-popular query 

All additional queries (Separated by beginning and ending parentheses). 
All filter items (Separated by beginning and ending parentheses). 

File filter string. 


The number of times the current query was requested by all users during 
the logging period. 


The number of searches represented by the top number of queries listed. 


The number of the current loop; see the optional # in 
$$BeginResultPageLoop|#]. 1-based 


The total number of unique queries requested by all users during the 
logging period. 
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12.11.8 


Name 


$$BeginHasSubQuery 


$$EndHasSubQuery 


Top Queries 


Description 


Everything between BeginHasSubQuery and EndHasSubQuery is 
displayed if any subqueries or filters were sent in the query. 


Everything between BeginHasSubQuery and EndHasSubQuery is 
displayed if any subqueries or filters were sent in the query. 


Table 12-15 Top Queries Query Report Template Variables 


Name 


$$BeginIndexQueryLoop[#] 


$$EndIndexQueryLoop 


$$IndexQuery 
$$IndexQueryTotal 


$$IndexQuerySubTotal 


$$IndexQueryCurrent 


$$IndexQueryCount 


By Index 


$$BeginRptIndexesLoop[+] 


$$EndRptindexesLoop 
$$Rptindex 
$$RptindexQueries Total 


$$RptindexCurrent 


$$RptindexCount 


By Index Combinations 


$$BeginRptFulllndexesLoop 


Description 


Begins a repeating section that displays the queries associated with 
the most popular indexes or the most popular index combinations. 
The loop is repeated for the top number of queries. The optional 
number defaults to 25 if not provided. 


Ends a repeating section that displays the queries associated with 
the most popular indexes or the most popular index combinations. 


The current query associated with the index or index combination. 


The number of times the current query was requested by all users 
during the logging period. 


The number of searches represented by the number of queries 
listed. 


The number of the current loop; see the optional # in 
$$BeginIndexQueryLoop|#]. 1-based. 


The number of unique queries associated with the current index or 
index combination. 


Begins a repeating section that displays the most popular indexes. 
The loop is repeated for the top number of indexes. The optional 
number defaults to 1000 (that is, all indexes) 


Ends a repeating section that displays the most popular indexes. 
The name of the current index. 
The total number of times the current index was used in a query. 


The number of the current loop; see the optional # in 
$$BeginRptindexesLoop|#]. 1-based. 


The total number of times the current index searches unique 
indexes available for searching (including those that were never 
used in a user query). 


Begins a repeating section that displays the most popular index 
combinations. All index combinations are displayed. 
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Name 


$$EndRptFulllndexesLoop 


$$RptFulllndex 


$$RptFulllndexQueries Total 


$$RptFulllndexCurrent 


$$RptFulllndexCount 


12.11.9 Error Searches 


Description 


Ends a repeating section that displays the most popular index 
combinations. 


Displays the list of indexes corresponding to the current loop. 


The total number of times the current index combination was used in 
a query. 


The number of the current loop. 1-based. 


The total number of unique index combinations available for 
searching (including those that were never used in a user query). 


Table 12-16 Error Searches Query Report Template Variables 


Name 


$$BeginErrorQueriesLoop[#] 


$$EndErrorQueriesLoop 


$$ErrorQuery 
$$ErrorSubQuery 
$$ErrorFilterQuery 
$$ErrorFileFilterQuery 


$$ErrorQueryTotal 


$$ErrorQuerySubTotal 


$$ErrorQueryCurrent 


$$ErrorQueryCount 


$$BeginHasErrorSubQuery 


$$EndHasErrorSubQuery 


Description 


Begins a repeating section that displays the searches that produced an 
error. The loop is repeated for the top number of error queries. The 
optional number defaults to 50. 


Ends a repeating section that displays the searches that produced an 
error. 


The current error query. 

All additional queries (Separated by beginning and ending parentheses). 
All filter items (Separated by beginning and ending parentheses). 

File filter string. 


The number of times the current error query was requested by all users 
during the logging period. 


The number of searches represented by the top number of error queries 
listed. 


The number of the current loop; see the optional # in 
$$BeginErrorQueriesLoop[#]. 1-based. 


The total number of unique error queries requested by all users during 
the logging period. 


Everything between BeginHasErrorSubQuery and 
EndHasErrorSubQuery is displayed if any subqueries or filters were sent 
in the query. 


Everything between BeginHasErrorSubQuery and 
EndHasErrorSubQuery is displayed if any subqueries or filters were sent 
in the query. 


152 OES 11 SP2: Novell QuickFinder Server 5.0 Administration Guide 


12.11.10 


Not Found Searches 


Table 12-17 Not Found Searches Query Report Template Variables 


Name 


$$BeginNotFoundQueriesLoop[+*] 


$$EndNotFoundQueriesLoop 


$$NotFoundQuery 
$$NotFoundSubQuery 


$$NotFoundFilterQuery 
$$NotFoundFileFilterQuery 


$$NotFoundQueryTotal 


$$NotFoundQuerySubTotal 


$$NotFoundQueryCurrent 


$$NotFoundQueryCount 


$$BeginHasNotFoundSubQuery 


$$EndHasNotFoundSubQuery 


$$BeginNotFoundiIndexesLoop 


$$EndNotFoundIndexesLoop 


$$NotFoundindex 
$$NotFoundIndexQueriesTotal 
$$NotFoundIndexCurrent 


$$NotFoundIndexCount 


Description 


Begins a repeating section that displays the searches that produced 
a Not Found response. This includes the searches that were 
successfully resolved by looking elsewhere using the Search 
Expansion feature. The loop is repeated for the top number of Not 
Found queries. The optional number defaults to 50. 


Ends a repeating section that displays the searches that produced a 
Not Found response. 


The current Not Found query. 


All additional queries (separated by beginning and ending 
parentheses). 


All filter items (separated by beginning and ending parentheses). 
File filter string. 


The number of times the current Not Found query was requested by 
all users during the logging period. 


The number of searches represented by the top number of Not 
Found queries listed. 


The number of the current loop; see the optional # in 
$$BeginNotFoundQueriesLoop[#]. 1-based. 


The total number of unique Not Found queries requested by all 
users during the logging period. 


Everything between BeginHasNotFoundSubQuery and 
EndHasNotFoundSubQuery is displayed if any subqueries or filters 
were sent in the query. 


Everything between BeginHasNotFoundSubQuery and 
EndHasNotFoundSubQuerv is displayed if any subqueries or filters 
were sent in the query 


Begins a repeating section that displays the indexes associated with 
the current Not Found query. The loop is repeated for all associated 
indexes. 


Ends a repeating section that displays the indexes associated with 
the current Not Found query. 


The name of the current index. 
The number of Not Found queries for a particular index. 
The number of the current NotFoundindex loop. 1-based. 


The total number of indexes associated with the current Not Found 
query. 
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12.11.11 


12.11.12 


12.11.13 


Redirected Searches 


Table 12-18 Redirected Searches Query Report Template Variables 


Name 


$$BeginRedirectsLoop[#] 


$$EndRedirectsLoop 


$$RedirectedQuery 


$$RedirectedQueryTotal 
$$RedirectedQuerySubTotal 


$$RedirectedQueryCurrent 


$$RedirectedQueryCount 


Login Requests 


Description 


Begins a repeating section that displays the searches that were 
redirected to a specific, admin-defined URL. The loop is repeated for the 
top number of redirected queries. The optional # defaults to 50. 


Ends a repeating section that displays the searches that were redirected 
to a specific, admin-defined URL. 


The current redirected query. 


The number of times the current redirected query was requested by all 
users during the logging period. 


The number of searches represented by the top number of redirected 
queries listed. 


The number of the current loop. 1-based. 


The total number of unique queries that were redirected. 


Table 12-19 Login Requests Query Report Template Variables 


Name 


$$BeginLoginUsersLoop 
$$EndLoginUsersLoop 


$$LoginUser 


$$LoginUserTotal 


$$LoginUserCurrent 


$$LoginUserCount 


Print Details 


Description 


Begins a repeating section that displays the individual users who were 
authenticated through QuickFinder. 


Ends a repeating section that displays the individual users who were 
authenticated through QuickFinder. 


Displays the name of the current logged-in user. 


Displays the total number of times the current user logged in through 
QuickFinder. 


The number of the current loop. 1-based. 


The total number of unique users that successfully logged in through 
QuickFinder. 


Table 12-20 Print Details Query Report Template Variables 


Name 


$$PrintTotal 


Description 


Displays the total number of print requests handled by QuickFinder 
during the log period. This includes all print request types (Successful and 
unsuccessful). 
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Name 


$$SuccessfulPrints 
$$NotFoundPrints 
$$ErrorPrints 


$$AvgNumHitsPerPrint 
$$AvgTotalPrints 


$$AvgPrintTime 


Print Errors 


Description 


Displays the total number of print requests that resulted in successful 
printed output. 


Displays the total number of print requests that resulted in a Not Found 
response. 


Displays the total number of print requests that resulted in an error 
condition. 


Displays the average number of results per print request. 
Displays the average number of total results per print request. 


Displays the average amount of time required to process a print request. 
Print requests take much longer than searches because the individual 
documents must be retrieved from their source location, converted into 
QuickFinder’s internal Unicode format, then streamed back to the user by 
using the specified output encoding. 


Table 12-21 Print Errors Query Report Template Variables 


Name 


$$BeginPrintErrorsLoop 


$$EndPrintErrorsLoop 


$$PrintErrorQuery 
$$PrintErrorSubQuery 


$$PrintErrorFilterQuery 
$$PrintErrorFileFilterQuery 


$$PrintErrorQueryTotal 


$$PrintErrorQuerySub Total 


$$PrintErrorQueryCurrent 


$$PrintErrorQueryCount 


$$BeginHasPrintErrorSubQuery 


$$EndHasPrintErrorSubQuery 


Description 


Begins a repeating section that displays the print requests that 
produced an error condition. The loop is repeated for the top number 
of print requests. The optional number of defaults to 50. 


Ends a repeating section that displays the print requests that 
produced an error condition. 


The current print request that resulted in an error response. 


All additional queries (Separated by beginning and ending 
parentheses). 


All filter items (Separated by beginning and ending parentheses). 
File filter string. 


The number of times the current print request was issued by all users 
during the logging period. 


The total number of print requests represented by the current list of 
print errors. 


The number of the current loop. 1-based. 


The total number of unique print requests that produced an error 
response. 


Everything between BeginHasPrintErrorSubQuery and 
EndHasPrintErrorSubQuery is displayed if any subqueries or filters 
were sent in the query. 


Everything between BeginHasPrintErrorSubQuery and 
EndHasPrintErrorSubQuery is displayed if any subqueries or filters 
were sent in the query. 
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12.11.15 


12.11.16 


Highlight Details 


Table 12-22 Highlight Details Query Report Template Variables 


Name 


$$HighlightTotal 


$$SuccessfulHighlights 
$$ErrorHighlights 


$$AvgHighlightTime 


Export Details 


Description 


Displays the total number of requests for QuickFinder to highlight the 
user’s search terms within the original document. This includes both 
successful and unsuccessful highlight attempts. 


Displays the total number of successful requests for QuickFinder to 
highlight the user’s search terms within the original document. 


Displays the total number of highlight requests that resulted in an error 
condition. 


Displays the average amount of time required to highlight a user’s search 
terms within the original document. The majority of the time is spent 
retrieving the original document. 


These template variables are used to export a raw version of the entire contents of the query log. The 
ReportTemplate.html file summarizes the queries for a certain date, and the Export Template .xml 
file contains a complete copy of the query log formatted so that other query reporting engines can 


consume the results. 


Table 12-23 Export Details Query Report Template Variables 


Name 


$$BeginEXPORTLoop 


$$EndEXPORTLoop 


$$EXPORTDate 
$$EXPORTType 
$$EXPORTUser 
$$EXPORTUserID 


$$EXPORTLocale 


$$BeginEXPORTIndexes 


$$EndEXPORTIndexes 


$$EXPORTIndex 


Description 


Begins a repeating section that exports the query details and subsequent 
response information associated with all QuickFinder Search, Print, and 
Highlight requests. 


Ends a repeating section that exports the query details and subsequent 
response information associated with all QuickFinder search, print, and 
highlight requests. 


Exports the time and date of the request. 

Exports the type of request: search, print, or highlight. 
Exports the IP address making the request. 

Exports the logged-in UserID, if available. 


Exports the first locale provided by the request. For example, en or 
en_US. 


Begins a repeating section that exports the indexes associated with a 
request. 


Ends a repeating section that exports the indexes associated with a 
request. 


Exports the name of the current index associated with the request. 
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Name 


$$BeginEXPORTQueries 


$$EndEXPORT Queries 


$$EXPORTQuery 


$$BeginEXPORTFilters 


$$EndEXPORTFilters 


$$EXPORTFilter 


$$EXPORTFileFilter 


$$EXPORTResult 


$$EXPORTTemplate 


$$EXPORTPage 


$$EXPORTHits 


$$EXPORT TotalHits 


$$EXPORTTime 


Description 


Begins a repeating section that exports the user queries associated with 
each request. Users can send multiple weighted queries with each 
QuickFinder request. 


Ends a repeating section that exports the user queries associated with 
each request. 


Exports the current user query associated with the QuickFinder request. 
Users can send multiple weighted queries with each request. 


Exports the filters associated with each QuickFinder request. A filter is 
used to send additional hidden details with each query. Multiple filters can 
be associated with each query. Multiple queries can be associated with 
each request. 


Exports the filters associated with each QuickFinder request. A filter is 
used to send additional hidden details with each query. Multiple filters can 
be associated with each query. Multiple queries can be associated with 
each request. 


Exports the value of the current filter. 
Exports the value of the file filter associated with the current request. 


Exports the type of the response returned from processing the request: 
Normal | Expanded | Redirected | ShowFirst | SearchPage | Login | 
Logout | NotFound | Error | SwitchProtocols. 


Exports the name of the template associated with the QuickFinder 
response. 


Exports the number of the search results page. Begins with 1. Used only 
for Normal, Expanded, and ShowFirst result types. 


Exports the number of hits associated with the current Search Results 
page. 


Exports the total number of hits associated with the current request. 


Exports the number of milliseconds required to fully process the request. 


Search Parameters 


The following table lists and describes all available search parameters. Each of these parameters can 
be used to extend or enhance the functionality of the search page templates or to create new search 


page templates. 


For more information about how to implement parameters in an HTML document, see Chapter 13, 
“Customizing Your Templates and Search Forms,” on page 167. 





NOTE: If you use a parameter but leave its value blank, the default value for that parameter is used. 
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Table 12-24 Search Parameters 


Name 


basiclogin 


bbindex 


bbshow 


bbnum 


buttonpressed 


context 


Value 


Boolean 


String 


Boolean 


Integer 


String 


String 


Description 

Displays the browser's basic authentication dialog box. 
Syntax: basiclogin=true/false 

Options: True, False 

Example: basiclogin=True 


Specifies which best bets index to use. Can be used multiple times to 
specify additional indexes. Overrides the default setting. 


Syntax: bbindex=variable 

Alternate Syntax: bbindex-indexname; indexname 
Example: bbindex-mvindex 

Default: None (specified using QuickFinder Server Manager) 


Specifies whether or not the best bets list should be shown on the 
search results page. Overrides the default setting. 


Syntax: bbshow=true/ false 

Options: True, False 

Example: bbshow-true 

Default: True (Specified using QuickFinder Server Manager) 


Specifies the number of best bets to show on the results page. 
Overrides the default setting. 


Syntax: bbnum=variable 


Options: Any positive number less than or equal to the maximum 
number specified in QuickFinder Server Manager. 


Example: bbnum=5 
Default: None (specified using QuickFinder Server Manager) 


A button clicked by the user. If this value is part of the query, then a 
response message should not be sent to the client. 


Syntax: buttonpressed=button_name 


Options: Yes, No, OK, Cancel, Continue, Ignore, Retry, Prev, Next, 
Help. 


Example: buttonpressed=Cancel 

Overrides the user’s default context for the current login. 
Syntax: context=variable 

Example: context=sales.novell 


Default: None (specified using QuickFinder Server Manager) 
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Name 


countrv 


date 


encoding 


expandindex 


filefilter 


Value 


String 


Integer 


String 


String 


String 


Description 


Specifies vour countrv using the two-character, uppercase countrv 
value derived from ISO 3166 (http://www.iso.org/iso/ 
countrv names and code elements). 


Svntax: countrv-countrv code 
Example: countrv-TW 
Default: As specified bv Web browser language preferences. 


Specifies a date range to be searched in milliseconds. If you pass a 
positive number such as 940457147873, then QuickFinder creates a 
date and time based on the number of milliseconds elapsed since 
January 1, 1970, 12:00 a.m. For example, the number 
940457147873 produces the search start date of October 20, 1999, 
at 4:05:47 p.m. 


The example shows the number of milliseconds spanning a three- 
month time frame. The minus sign (-) before the number indicates 
three months back in time. 


Syntax: date=number 
Example: date=-7905600000 


Specifies the character set encoding used to encode the search 
request itself. 


Syntax: encoding=value 
Example: encoding=Shift_JIS 
Default: UTF-8 (specified using QuickFinder Server Manager) 


Specifies an expanded search index. You can specify more than one 
index at a time. Overrides the default setting. 


Syntax: expandindex=variable 


Alternate Syntax: expandindex-indexnamel; indexname2 ; 
indexname3 


Example: expandindex=developerindex 
Default: None (specified using QuickFinder Server Manager) 


Filters search results based on their path, domain, filename, or 
extension. Uses the same query syntax as the &query= parameter. 


NOTE: If a primary &query= parameter is not provided, then 
QuickFinder automatically performs a filename-only search. 


Syntax: filefilter=search criteria 
Example: filefilter=.exe 


Example: filefilter=.com 
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Name Value Description 


filterquerv number String The &filter#= query parameter is used to send additional query 
details not specified bv the user in order to help limit the scope ofa 
search. Normallv, these are included as hidden fields on an HTML 
form. 


This parameter supports all of the same features and functionalitv as 
the &query= parameter. However, unlike the &query= parameter, this 
parameter can be sent multiple times for a single query item. 


The individual filters associated with a single query item are joined 
using the value of the filteroperator parameter. The set of filters is 
logically joined with the rest of the query item by using the Boolean 
AND operator. 


Syntax: filterquery number=searchcriteria 
Example: filter0="product=GroupWise 
See also “filteroperatorquery_number” on page 160. 


filteroperatorquery_num Number Boolean conjunction to be used between multiple filters (several 

ber filters can be associated with a single query item). The complete set 
of filters is always associated with the corresponding query item 
using the Boolean AND operator. 


Syntax: filteroperatorquery_number=number 
Options: O (AND), 1 (OR), 2 (PHRASE) 

Example: filteroperator0=1 

Default: 1 (OR) 


See also the query parameters “operatorquery_number” on 
page 162 and “filterquery_number” on page 160. 


gettotalhits Boolean Enables or disables the total number of hits calculation. For example, 
if you set the gettotalhits parameter to False, the Total Number of 
Hits label on the results page displays O (zero). Setting this 
parameter to True shows the total number of hits found during the 
search. In some complex situations, this can save valuable 
processing time. 


Syntax: gettotalhits=True/False 
Options: True, False 

Example: gettotalhits=False 
Default: True 


idquery_number String Document ID that is used to narrow a search. You can specify more 
than one ID by using the same field name more than once. 


Syntax: idquerv number-documentID 
Example: &id0=z1.0010.&id0=z1.0020 


Default: None 
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Name 


index 


lang 


login 


logout 


noexpand 


noredirect 


Value 


String 


String 


Boolean 


Boolean 


Boolean 


Boolean 


Description 


Restricts a search to one or more specified indexes. The index name 
you specify with this parameter must exactly match the name of an 
index defined at the server. 


You can specify more than one index by either sending this 
parameter more than once or by separating the list of indexes with a 
semicolon (;). 


Syntax: index-index namell;index namez) 
Example: index=GroupWise&index=Linux 
Example: index-GroupWise;Linux 


Default: All indexes or the list of default indexes specified in 
QuickFinder Server Manager. 


Specifies a language using the two-character, lowercase language 
value derived from ISO 639-2 (http://www.loc.gov/standards/iso639- 
2/php/code_list.php). 


Syntax: lang=language_code 
Example: lang=ja 
Default: Browser language preference. 


When set to True, displays a form-based login rather than the 
standard browser-based login dialog box. 


Syntax: login=True/ False 

Options: True, False 

Example: login=True 

When set to True, logs out the current user. 
Syntax: logout=True/ False 

Options: True, False 

Example: logout-True 

When set to True, turns off search expansion. 
Syntax: noexpand=variable 

Options: True, False 

Example: noexpand=True 

When set to True, turns off URL redirection. 
Syntax: noredirect=True | False 
Options: True, False 


Example: noredirect=True 
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Name Value Description 


numhits Integer Number of hits you want returned at one time in the search results 
page. 


Syntax: numhits=number 

Example: numhits=25 

Default: 25 (specified using QuickFinder Server Manager) 
operatorquery_number Integer Which operator to use between two or more words in a search. 

Syntax: operatorquery_number=number 

Options: 0 (AND), 1 (OR), 2 (PHRASE) 

Example: operator0=1 

Default: O (specified using QuickFinder Server Manager) 
password String User's password for form-based logins. 

Syntax: password=variable 

Example: password=novell 
queryquery_number String Actual search criteria passed to the QuickFinder Server. 


Because multiple queries can be defined in a single search request, 
the number variable lets you group various parameters together that 
apply to a specific query. Adding the same number to two or more 
parameters groups them together so they can be applied to the same 
query. For example, &queryO=product+downloads&weightO=100 
groups the &weight query parameter together with ġquervo. 


This parameter is used most often with operatornumber, 
filternumber, filteroperatornumber, idnumber, weightnumber, and 
typenumber. 


Syntax: queryquery_number=searchcriteria 
Example: query0=novell+AND+groupwise 


For more information, see Section 10.7, “Weighted Queries,” on 
page 119. 


relevance String Whether or not to sort the search results by relevance. Turning this 
feature off is a potential speed gain because the sort algorithm won't 
run. 


Syntax: relevance=True | False 
Options: True, False 
Example: relevance=False 


Default: True 
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Name 


retencoding 


resulttitle 


retfield 


server 


showfirsthit 


Value 


String 


String 


String 


String 


Boolean 


Description 


Specifies the character set encoding to be used by the next results 
page returned to the user. 


Syntax: retencoding-character set encoding 
Example: retencoding-iso-8859-1 
Default: UTF8 (specified using QuickFinder Server Manager) 


Lets you select the search results by either title or URL. If you select 
the Result title or URL option, then the search result displays either 
title content or the URL. If you select the Result URL option, then the 
path or the URL is displayed as the result title. 


Syntax: resulttitle=number 
Example: resulttitle=2 


Level of detail given about each result item. The fewer the details, 
the faster a search is returned to a user. 


Field names include title, author, URL, changedate, language, 
summary, relevance, index, format, and filelength. 


IMPORTANT: Type these fields exactly as they appear above. 


To specify more than one field, separate them with an ampersand 


(8). 

Svntax: retfield-field name 

Example: retfield-title 

Example: retfield=title&retfield=author 


Name of the virtual search server that is to receive this request. This 
query parameter is optional if the domain name of the request 
matches the name or alias of a registered virtual search server. 


Syntax: server=virtual search server name 





Example: server-digitalairlines 
Default: Domain name portion of search request 


If set to True, this parameter automaticallv goes to the URL of the 
first hit on the current page rather than displaving the search results 


page. 

Syntax: showfirsthit=True/ False 
Options: True, False 

Example: showfirsthit=True 


Default: False 
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Name Value 
sortbvdate String 
sortfieldquerv number String 
sortkevs Integer 
sortorderquerv number Integer 
starthit Integer 
svnflag String 


164 


Description 


Sorts the Total Search Results list bv date, ignoring the normal 
relevance ordering. 


Syntax: sortbydate=True | False 
Options: True, False 

Example: sortbydate=True 
Default: False 


Specifies the fields on which to sort the search results returned in a 
results page. Grouped together with the sortorder query parameter 
by adding a number to the end of the parameter name. 


Field names include title, author, URL, changedate, language, 
summary, relevance, index, format, and filelength. 


IMPORTANT: Tvpe these fields exactiv as thev appear above. 
Svntax: sortfieldquerv number-field name 
Example: sortfieldl-title 


Specifies the number of sort fields that should be used to sort the 
search results. 


Svntax: sortkevs-number 
Example: sortkevs-1 


Specifies the alphanumeric ordering of search result items (hits). 
Grouped together with the sortfield query parameter by adding a 
number to the end of the parameter name. 


Syntax: sortorderquery_number=number 
Options: 0 (Ascending), 1 (Descending), 2 (Default for each field) 
Example: sortorderl-0 


Hit number you want QuickFinder to begin searching from. If you 
specify a value of 35, QuickFinder returns hits beginning with hit 
number 35. 


Syntax: starthit=number 
Example: starthit=35 
Default: 1 


When set to False, turns off synonym-enhanced searching. Also 
overrides the default specified in QuickFinder Server Manager. 


Syntax: synflag=True/ False 
Options: True, False 
Example: synflag=False 


Default: True 


OES 11 SP2: Novell QuickFinder Server 5.0 Administration Guide 


Name 


template 


theme 


Value 


String 


String 


Description 


Specifies the results template vou want vour search results returned 
in. The following list includes the default templates included with the 
QuickFinder Server. However, vour QuickFinder Server administrator 
might have created custom templates using different names. Check 
with vour administrator if the default templates do not work for vou. 
Vou must tvpe the names of these templates exactiv as thev appear 
in this list: 


* ResultListTemplate.html 

* ResultListTerseTemplate.html 
* ResultListVerbose.html 

* PrintResultTemplate.html 

+ SearchTemplate.html 


t HighlighterTemplate.html 


Localized versions for multiple languages can also be used. See 
Section 14.1, “Working with Multiple Languages,” on page 171. 


TIP: A number of different file formats can be used as QuickFinder 
templates. For example, QuickFinder ships both HTML and XML 
templates. QuickFinder uses the current template filename extension 
to determine which template filename to use next. For example, ifa 
user specifies the ResultListTerseTemplate.xml file for the 
current query, but the search produces a Not Found condition, 
QuickFinder automatically tries to find a template named 
ResultListNoHitsTemplate.xml. 


Syntax: template-filename 
Example: template=ResultList.html 


Default: Search Page (SearchTemplate.html), Search Results 
(ResultListTemplate.html), and Print 
(PrintResultTemplate.html) 


Default templates are specified using QuickFinder Server Manager. 


Name of the theme (or directory within the templates directory) 
where a complete set of search and print templates are stored. 


Syntax: theme=theme_name 


Example: theme=Intranet 
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Name Value Description 


tvpequerv number Integer Type of search. 


0 = Normal search; this is the default. 
1 = Searches only the given document numbers. 


2 = Root search used by the search tree control to get the top tree 
nodes. 


3 = Used to get the children of the given document number. 
4 = Searches the descendants of the given document numbers. 


Used to narrow a search or a print request, including all of its 
children. 


Syntax: typequery_number=number 
Options: 


0 = Normal search; this is the default. 
1 = Searches only the given document numbers. 


2 = Root search used by the search tree control to retrieve the top 
tree nodes. 


3 = Retrieves the children of the given document number. 


4 = Searches the descendants of the given document numbers. 
Used to narrow a search or a print request, including all of its 
children. 


Example: type0=2 
Default: 0 (zero) 


url String Specified as a parameter to the Highlight servlet to determine the 
URL to highlight. The URL is highlighted only if the current user has 
rights to the file. The value must be properly URL-escaped. 


Syntax: url=value 

Example: 

url=http%3A%2F%2Fwww.novell.com%2Findex.html 
userid String User ID for form-based logins. 

Syntax: userid=variable 

Example: userid=jsmith 


weightquery_number Integer Assigns a level of importance to the current query item as it relates to 
the other query items that are part of the search query. QuickFinder 
Server uses this number along with the relevance number to 
determine a search result’s final relevance and then orders the 
results accordingly. 


Range: 0 to 100 
Syntax: weight query number-number 
Example: weight 0=75 


Default: 100 
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13.1 


13.1.1 


Customizing Vour Templates and Search 
Forms 


You can quickly create a custom search solution by modifving the default QuickFinder templates. 
Templates include some fundamental options for users, but you can add or remove options and 
modify the form layout and design to give the search form the look, feel, and function you need. If 
you are creating a hosted search service for another company's Web site, you can modify the 
templates to match the look and feel of their Web site. 


If you are confident in coding with HTML, you can start with the default search page template to get 
a feel for the available parameters and then begin coding completely new search and print templates 
from scratch. 


This section includes the following topics: 


è Section 13.1, “Customizing Templates,” on page 167 


+ Section 13.2, “Testing Your Search and Print Solution,” on page 170 


Customizing Templates 


You can extend the capabilities of QuickFinder Server by customizing the templates. 


The first step is to determine which components of QuickFinder you want to customize. For example, 
if you only want to add a few additional search features to the search page template and modify its 
background color and table size, you would modify the SearchTemplate.html or 

SearchTemplate. Simple files. 


This section discusses how to customize the search, print, and result templates and how to use 
available parameters and variables to create a customized search solution. 


è Section 13.1.1, “Customizing the Search Templates,” on page 167 
+ Section 13.1.2, “Customizing Search Result Templates,” on page 168 
+ Section 13.1.3, “Customizing Print Result Templates,” on page 169 


+ Section 13.1.4, “Customizing Error and Response Message Templates,” on page 169 


Customizing the Search Templates 


You can customize the design and functionality of the static or dynamic search templates by 
+ Modifying HTML code 
+ Adding or removing search parameters 


If you are familiar with HTML, you can quickly modify the design of the default (dynamic) search 
template or the static search template. For example, you can change the colors of the search page or 
add new custom graphics. 
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13.1.2 


To modifv the functionalitv of the default search template, vou can add or remove search parameters. 
Search parameters are used to communicate with QuickFinder. Bv embedding them in the correct 
places in your HTML source, you can extend or limit the functionality of the default search template. 


For example, if you wanted your users to use a specific set of templates found in a themes directory, 
you would add the following HTML code, including the theme parameter, to the 
SearchTemplate.html file: 


<INPUT TYPE="Hidden” NAME="theme” VALUE="$SQueryTemplateTheme” > 


This sample HTML code tells QuickFinder to look for templates only in the specified template 
directory. All themes are located within the templates directory specified in QuickFinder Server 
Manager. 


For a complete list of available search parameters, see Section 12.12, “Search Parameters,” on 
page 157. 


Customizing Search Result Templates 


QuickFinder Server includes several default search result templates that are used to display hits, 
provide feedback to a user, or request information from a user after a search is performed. For more 
information about the default search result templates, see Chapter 11, “Understanding Templates,” 
on page 123. 


You can customize the design and functionality of the default search result template, which is the 
template used when a user selects Normal from the Result List Format drop-down list in the 
QuickFinder form. For information about how to access the QuickFinder form, see Section 1.5, 
“Taking a Test Run: Performing a Search,” on page 17. 


Customizing the default search result template involves 


+ Modifying the HTML code 


+ Adding or removing search result variables 


If you are familiar with HTML, you can quickly modify the design of the default search result 
template. For example, you can change the colors of the search page or add new graphics. 


To modify the functionality of the default search result template, you can add or remove search result 
variables. Search result variables are placed in the template where you want search results to be 
displayed. 


For example, if you want to display the total number of hits returned when a user performs a search 
and you want the information to appear in the upper left corner of the search results page, you would 
add the following HTML code to the search result template file: 


Total Search Results: $STotalHits 


After a user performs a search, the $$TotalHits variable is replaced by the actual total number of hits 
found during the search. 


The $$TotalHits variable is used to retrieve the total number of hits found during a search. You can 
place this variable anywhere in the results list template to organize the display of information in the 
way you want. 


Default search result templates are located in /<searchroot>/Templates where searchroot is the 
path where you installed QuickFinder. The default install location is /var/lib/qfsearch. For a 
complete list of search result variables that you can use to customize default search result templates 
or to create new ones, see Section 12.6, “Search Result Variables,” on page 137. 


168 OES 11 SP2: Novell QuickFinder Server 5.0 Administration Guide 


13.1.3 


13.1.4 


Customizing Print Result Templates 


Print result templates are used to organize and format search results for printing and to provide 
feedback to a user when no hits are found. QuickFinder Server includes two default print result 
templates: the default print result template and a 'no hits' template.For more information about the 
default print result templates, see Chapter 11, 'Understanding Templates,' on page 123. 


Xou can customize the design and functionalitv of the default print result template in the same wav 
you customize the search result template: 


€ Modifying the HTML code 


¢ Adding or removing print result variables 


If you are familiar with HTML, you can quickly modify the design of the default print result 
template. For example, you can change the colors of the print results page or add new graphics to it. 


To modify the functionality of the default print result template, you can add or remove print result 
variables. Variables are placed in the template where you want search results to be displayed. 


For example, if you wanted to remove the table of contents from the default print result template, you 
would remove, or comment out, the following HTML code in the PRINTRESULTLIST . HTML template, 
which would include the $$BeginTOCList variable: 


<CENTER><H2>Table of Contents</H2></CENTER><p><! -- TABLE OF CONTENTS 
- >$$BeginTOChist [<BIG><B>$$Product</B></BIG><DL>] <DT><A 
HREF="#SSBookmark” ><BIG>S$$Title</BIG></A><SPACER TYPE=HORIZONTAL 
SIZE=20><I><SMALL> [SSURL] </SMALL></I>S$SEndTOCList [</DL>] 


You could either save your changes in the default print result list template or you could save it with a 
new name, thereby creating an alternative template for users who don’t want a table of contents in 
the print results. For the template to be effective, you would then need to add a hypertext link in the 
search result template that would include the &template=new_template_name query parameter. 


Default print result templates can be found at /<searchroot>/Templates where searchroot is the 
path where you installed QuickFinder. The default install location is /var/lib/qfsearch. For a 
complete list of print result variables that you can use to customize default search result templates or 
to create new ones, see Section 12.7, “Print Result Variables,” on page 140. 


Customizing Error and Response Message Templates 


Error and response messages are used to either provide feedback to the user or to request 
information from the user. 


Error and response message templates are used to display the content of error and response 
messages sent by the QuickFinder Server in response to search or print errors. Similar to search and 
print templates, error and response templates can be customized. However, because the contents of 
error and response messages are built into QuickFinder Server, you cannot modify the contents of the 
messages or the button objects that might appear, depending on the type of response being 
generated. 


+ “Customizing Error Messages” on page 170 


+ “Customizing Response Messages” on page 170 
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Customizing Error Messages 


There are several error messages that can be returned to a user. For example, when users incorrectly 
use a search operator in a search form, they might get the message, Search Error: Incorrect use 
of Boolean operator. An error number might also appear. 


Although you can use HTML tags to format an error message, add or remove variables to determine 
what information is shown to the user, or even reorganize where the messages appear in the 
template, you cannot modify the message itself. 


Customizing Response Messages 


The same concepts apply to response messages, but response messages return buttons that a user can 
click. Which buttons appear are determined by the QuickFinder Server. Although you can modify the 
labels of these buttons, you cannot determine which buttons appear, or when. 


Testing Your Search and Print Solution 


After you customize the templates and the search form, you can test them in your Web browser by 
pointing to the search form URL and entering a search string. See Section 1.5, “Taking a Test Run: 
Performing a Search,” on page 17 for information about how to access the QuickFinder form. 


Remember that a search cannot be performed until you have defined at least one index and generated 
it by using QuickFinder Server Manager. See Section 8.5, “Creating Indexes,” on page 79 and 
“Generating Indexes” on page 90 for more information. 
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Internationalizing Search Services 


QuickFinder Server is capable of handling search queries, search results, templates, and Web content 
in manv languages and character sets. QuickFinder can auto-detect languages and character sets, but 
to ensure a complete international search solution, must identifv language, countrv, and character 
information throughout vour QuickFinder implementation. 


This section discusses kev issues related to supporting multiple languages from a single search 
solution and includes the following topics: 


¢ Section 14.1, “Working with Multiple Languages,” on page 171 

+ Section 14.2, “Understanding Character Set Encodings,” on page 173 

+ Section 14.3, “Languages Included in the Default Templates,” on page 176 
è Section 14.4, “Additional Resources,” on page 177 


Working with Multiple Languages 


Customizing your search solution is important only if you want to let your users conduct language- 
specific searches. You specify the language of a template by inserting a language identifier in the 
meta tag of your templates or HTML files. The language identifier can also be used in Search Results 
pages to let users quickly recognize the search results that interest them. 


QuickFinder Server also lets Web clients specify their locale at the time the search query is entered. 
The default Search page illustrates this feature by auto-detecting a user's locale and selecting the 
appropriate language from the Display Language drop-down list. This selection sends two 
parameters to the QuickFinder Server: language and country. The country parameter is almost 
always blank. The search engine uses this information to find locale-specific versions of the templates 
used to return search results. 


To specify the language of a template or of any HTML content that is indexed as part of your virtual 
search server, you must specify a language identifier within an HTML file's header section. For 
example, if you wanted to identify a Russian template, you would add the following meta tag: 


<meta http-equiv="Content-Language” content="ru”> 


In some cases, such as Traditional and Simplified Chinese, you need to use the two-character, 
uppercase country codes. For example: 


<meta http-equiv="Content-Language” content="zh-TW"“><meta http-equiv="Content- 
Language” content="zh-CN”> 


The first line of the example indicates the Chinese language (ZH) and the geographic location as 
Taiwan. The second line of the example indicates the Chinese language (ZH) but China as the 
geographic location. 


This combination of language and country codes is called a locale. For more information about 
locales, refer to Section 14.4, “Additional Resources,” on page 177. 
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Specifving Locales within Template Filenames 


QuickFinder Server consists of three primary servlets: SearchServlet, PrintServlet, and AdminServlet. 
Each servlet returns information to the Web client by using server-side templates. Templates are 
stored at /<searchroot>/Templates where searchroot is the path where you installed QuickFinder. 
The default install location is /var/lib/qfsearch. For more information about templates, see 
Chapter 11, “Understanding Templates,” on page 123. 


After determining a Web client's locale, QuickFinder attempts to locate a matching search result 
template. That is, each of the QuickFinder services automatically attempts to locate a version of the 
requested template that most closely matches the Web client's locale. 


IMPORTANT: QuickFinder cannot find locale-specific templates without the two-character 
language code and the optional two-character country code. See Section 14.4, “Additional 
Resources,” on page 177 for more information about language code syntax. 





For example, if a Web client requests to see search results by using the ResultListTemplate.html 
file and the clientis a Chinese language user from Taiwan and the server is Russian, then 
QuickFinder tries to find a Chinese-Taiwan version of the template first 
(ResultListTemplate zh TW.html) because that exactly matches the client's language and country. 
The following table lists the template names the system looks up in this example in order of priority. 


Table 14-1 Template Name Priority (Chinese-Taiwan) 


Template Name What QuickFinder Concludes 

1. ResultListTemplate_zh_TW.html Specific client locale 

2, ResultListTemplate zh.html Simplified client locale 

3. ResultListTemplate. html Client requested name 

4. ResultListTemplate ru.html Specific server locale (no simplified versions) 
5. ResultListTemplate en.html English language version 

6. ResultListTemplate.html Up to the first underscore (. ) 























If this scenario were reversed so that the search client was Russian and the server was Chinese 
(Taiwan), and the client requested the ResultListTemplate ja.html template, then the lookup 
order follows the order shown in the following table. 


Table 14-2 Template Name Priority (Japanese) 


Template Name What QuickFinder Concludes 
1. ResultListTemplate ja ru.html Specific client locale (no simplified versions) 
2. ResultListTemplate ja.html Client requested name 


3. ResultListTemplate ja zh TW.html Specific server locale 


























A. ResultListTemplate ja zh.html Simplified server locale 
5. ResultListTemplate ja en.html English language version 
6. ResultListTemplate. html Up to the first underscore (_ ) 
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All templates undergo this rigorous lookup system. When a template is located, its name is stored 
and associated with the original client locale so that all subsequent requests for that template from 
the same locale automatically find the template without performing the same rigorous lookup. 


No further lookups are attempted for that combination of client locale and template name until the 
QuickFinder Server is restarted. If all template lookups fail, then an error message is returned to the 
client performing the search. 


Understanding Character Set Encodings 


A character set is a grouping of alphabetic, numeric, and other characters that have some relationship 
in common. For example, the standard ASCII character set includes letters, numbers, symbols, and 
control codes that make up the ASCII coding scheme. A character set encoding is the mapping of a 
character set to a value that can be understood and processed by a computer. 


QuickFinder relies on character set encodings to identify the characters used when performing a 
search, reading a template, posting results to a Web browser, or indexing Web-based content. If the 
encoding information is missing in any of these areas, QuickFinder uses the default encodings 
identified in the SearchServlet and PrintServlet properties files. You can modify these settings by 
using QuickFinder Server Manager. 


Because most languages have several encodings that identify their character sets, QuickFinder Server 
supports a wide variety of character set encodings and encoding aliases. 


Some examples of character set encodings include iso-8859-1, shift_jis, big5, and latin2. The official 
list of registered encodings is available from the Internet Assigned Numbers Authority (see 

Section 14.4, “Additional Resources,” on page 177). These are the official names for character sets that 
can be used in the Internet and can be referred to in Internet documentation. However, not all IANA- 
registered character set encodings are supported by QuickFinder Server. Refer to Section 14.4, 
“Additional Resources,” on page 177 for a list of encodings and encoding aliases that are supported 
by QuickFinder Server. 


+ Section 14.2.1, “Unicode and UTF-8,” on page 173 

* Section 14.2.2, “Search Encodings,” on page 174 

+ Section 14.2.3, “Response Encodings,” on page 174 

+ Section 14.2.4, “HTML Encodings,” on page 175 

+ Section 14.2.5, “Template Encodings,” on page 175 

+ Section 14.2.6, “Encoding Issues When Printing,” on page 176 


Unicode and UTF-8 


Unicode is a 16-bit character encoding standard developed by the Unicode Consortium. By using two 
bytes to represent each character, Unicode enables almost all of the written languages of the world to 
be represented with a single character set. Unicode does not require any special processing to access 
any character in any language. 


This makes Unicode very easy to use when processing text from multiple languages and scripts. This 
is the reason QuickFinder converts all external files into Unicode for processing. 


As already mentioned, Unicode is two bytes wide for all characters. Although this is ideal for 
computer processing, it doubles the size of all single-byte languages. This has a significant impact on 
Internet performance. For this reason, QuickFinder also supports an alternate representation of 
Unicode known as UTF-8. UTF-8 is a Unicode Transformation Format that uses sequences of 1 to 6 
bytes to represent all the characters in the Unicode standard. Most notably, ASCII characters are 
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transmitted without anv conversion at all. This means that most Internet content is alreadv in the 
UTF-8 representation. Manv Asian languages, however, require three bvtes per character in the UTF- 
8 format. Other languages can require up to six bvtes to represent each of their characters. 


You need to decide if Unicode or UTF-8 best meets your needs when creating HTML content, 
QuickFinder templates, or search pages. 


Search Encodings 


The only encodings QuickFinder currently supports when performing a search are Unicode and 
UTF-8. Therefore, any page that allows Web users to enter a search must ensure that the results are 
passed to the server in one of these two formats. See “Template Encodings” on page 175 for more 
information. 


To pass Unicode characters to QuickFinder, use the syntax %uHHHH, where 


+ The percent sign (90) is used as the CGI escape character 
+ The lowercase letter U (u) indicates that the subsequent 4 characters represent a Unicode value. 
+ Four uppercase H letters (HHHH) indicate four hexadecimal characters (0-9, A-F) 
To pass UTF-8 characters to QuickFinder, just use normal ASCII characters or the syntax % HH... for 
all other characters, where 
+ % is the CGI escape character 
+ HH indicates two hexidecimal characters (0-9, A-F) 


¢ %HH indicates additional %HH groupings that might be required to properly transmit a 
character 





TIP: If the encoding of the page containing a search form is already set to UTF-8 or Unicode, most 
browsers automatically transmit the entered search text correctly by using the designated encoding. 





By default, QuickFinder uses UTF-8 in its sample search pages. 


Response Encodings 


One of the many parameters that can be sent when conducting a search is the encoding that should 
be used when returning the results to the browser. All QuickFinder encodings listed in Appendix B, 
“Combined Character Sets for Use with QuickFinder,” on page 193 can be used. 


If the search result page contains the ability to refine or redo the search, then the response encoding 
can significantly impact the possible characters that can be entered when conducting the next search 
from this page. For example, if the user requests results in the iso-8859-1 encoding (HTMLs default), 
then only iso-8859-1 characters can be entered in the subsequent search from that page. Other 
characters can still be sent to the QuickFinder services by using the %uHHHH and %HH formats, but 
the browser does not allow users to enter normal text characters other than those supported by iso- 
8859-1. 


Although QuickFinder can return search results from many languages, some characters found in 
titles and descriptions might be returned as question marks (?) indicating that these characters are 
not available in the current response encoding. If a character can be represented in the current 
encoding but a font is not available, many browsers substitute an alternate character such as an 
empty box character. After the appropriate fonts have been installed, these characters display 


properly. 


By default, QuickFinder returns all search, print, and administration pages in UTF-8. 
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HTML Encodings 


Because HTML content can contain text written in many character sets, all HTML files need to 
include a tag that identifies the character set encoding. To identify the encoding of an HTML file (or 
search template), use the following meta tag at the top of the file's header section: 


<meta http-equiv="Content-Type” content="text/html; charset-Shift JIS'- 


In this example, you would replace Shift JIS with the appropriate Internet Assigned Numbers 
Authority (IANA)-assigned encoding value. 


Itis very important that the CHARSET value accurately represent the character set encoding that was 
actually used when the HTML Web content or QuickFinder template was created. A correct entry 
allows QuickFinder to accurately interpret and convert the characters in the document. An incorrect 
entry prevents QuickFinder from being able to read the characters as valid data in the authored 
language. 





IMPORTANT: Improperly identified characters result in garbled text. In some cases, the Web-based 
content cannot be properly indexed or printed. In the most severe cases, the document being read 
might produce a server-side exception, which ultimately discontinues processing the document and 
perhaps the entire operation. 





Because QuickFinder is Unicode-based, when reading templates or when indexing or printing HTML 
content, all character encodings are converted from their source encoding to Unicode for internal 
processing. 


During indexing, if a document contains characters not supported by the designated encoding, if the 
document doesn't have an encoding designation, or if the designation is inaccurate, the indexer 
attempts to recover. But if it cannot, it might index the information incorrectly or quit indexing that 
page entirely. 


When reading a template file, QuickFinder might automatically cease processing the file if it contains 
any characters not supported by the current encoding. It tries to ignore the invalid text and continue, 
but this might not be possible. 


When displaying search results or when printing HTML content, any character that does not match 
the specified response encoding receives a question mark (?) in its place when rendered at the 
browser. Although some characters are properly supported by the current encoding, the browser 
might not have the required fonts to display the characters. In this case, users might see square boxes 
representing these characters. This is an indication that the valid character reached the browser, but 
the operating system could not provide a font to properly render the character. The user then needs 
to either change fonts or install the correct fonts in order to properly display the characters. 





TIP: If a document does not contain a CHARSET encoding value, the default encoding for HTML 
documents is 1SO-8859-1, also known as Latini. The default encoding for plain text documents is US- 
ASCII. 


QuickFinder also allows administrators to define the default encodings for templates, HTML content 


when printing, and search and print responses. Refer to the QuickFinder Server Manager Help for 
information about changing the default encodings. 


Template Encodings 


All HTML documents should include a Content-Type meta tag identifying their character set 
encodings. The character set encoding allows HTML Web clients (or browsers) to understand the 
contents of the file. This tag is also used by browsers to automatically switch their display system and 
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fonts to correctly show the Web page's contents. This lets users surf the World Wide Web without 
constantly changing their display system as they encounter content from various languages and 
character sets. 


However, because QuickFinder lets administrators specify both template encodings and response 
encodings, browsers might be confused when presented with the valid response encoding in the 
HTTP header and one or more alternate encodings from the Content-Type meta tags within the file 
that was part of the original QuickFinder template. 





NOTE: $$IncludeFile[ ] templates can also contain their own Content-Type meta tags. 





To solve this problem, QuickFinder allows you to place the Content-Type meta tag specifying the 
template's encoding within an HTML comment. This effectively obscures the original template 
encoding from the browser, but still allows QuickFinder to read the encoding when the template file 
is processed. 


A sample QuickFinder template is given below. The Content-Type meta tag has been hidden inside of 
an HTML comment. This template can be embedded within other templates using the $$IncludeFile[ 
] template variable without affecting QuickFinder's ability to distinguish between the various 
encodings. This file can also be processed and then sent to a user's Web browser without conflicting 
with the response encoding provided by QuickFinder in the HTTP response headers. 


<html > 

<head><!-- Note that the HTML encoding command (meta tag) is hidden within a 
comment so that it does not affect a user's browser display. - ><!-- The actual 
encoding used when sending this file to the user is controlled by the response 
encoding - ><!-- <META HTTP-EQUIV="Content-Type” CONTENT="text/html; charset-iso- 
8859-1"> - ></head> 

<body> 


Template data here.</body> 
</html> 


Encoding Issues When Printing 


When QuickFinder processes a print request, it gathers the entire contents of each file and builds an 
appended print job page, one file after another. Each file can contain its own Content-Type meta tag 
identifying its encoding. Each file's encoding is used by QuickFinder to convert that file into Unicode 
before being sent out using the response encoding. 


Unfortunately, all of these encoding meta tags might confuse the browser's display system. Although 
QuickFinder has already properly converted the files into a single response encoding, the browser 
sees the Content-Type meta tags that direct it to do something else, and becomes confused. 


To solve this problem, you can create a print results template that contains a Content-Type meta tag 
encoding at both the top and bottom of the file, before and after the various documents are printed. 
All current browsers take either the first Content-Type meta tag that they encounter or the last. 
Constructing a print template with both satisfies all browsers. 


Languages Included in the Default Templates 


There are additional search and print templates for each of the following languages: 
+ Chinese (Traditional and Simplified) 
¢ English 


+ French 
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+ German 

¢ Italian 

¢ Japanese 
+ Korean 

+ Portuguese 
¢ Russian 

+ Spanish 


Templates are stored in /<searchroot>/Templates where searchroot is the path where you installed 
QuickFinder. The default install location is /var/lib/qfsearch. 


14.4 Additional Resources 


The following table lists additional resources for learning more about locales, country and language 
codes, and encodings. 


Table 14-3 Additional Internationalization Resources 


Component Resource Location 


Language and country codes RFC 1766 (http://www. ietf.org/rfc/rfc1766.txt) 


locale 
( NOTE: Although RFC 1766 uses the hyphen character ( - ) to separate 


language and country information, QuickFinder uses the underscore 
character ( _ ) in order to conform to the Java convention. 


ISO 639 (http://www.ics.uci.edu/pub/ietf/http/related/iso639.txt) 
ISO 3166 (http://www.chemie. fu-berlin.de/diverse/doc/ISO 3166.html) 


Character sets Internet Assigned Numbers Authority (IANA) Character Set registry (http:/ 
/www.iana.org/assignments/character-sets) 


Unicode Unicode Consortium home page (http:/Awww.unicode.org) 


UTF-8 UTF-8: A Transformation Format of ISO10646 (http://www. ietf.org/rfc/ 
rfc2279.txt) 


Internationalizing Search Services 177 


178 OES 11 SP2: Novell QuickFinder Server 5.0 Administration Guide 


15.1 


Securitv Considerations for QuickFinder 


Server 


This section provides specific instructions on how to configure and maintain QuickFinder Server in 


the most secure wav possible. 


¢ Section 15.1, “Security Features,” on page 179 


+ Section 15.2, “Security Characteristics,” on page 181 


è Section 15.3, “Security Configuration,” on page 182 


+ Section 15.4, “Other Security Considerations,” on page 186 


Security Features 


The following table contains a summary of the security features of QuickFinder: 


Table 15-1 QuickFinder Security Features 


Feature 


Users are authenticated 


Servers, devices, and/or services are 
authenticated 


Yes/No 


Yes 


No 


Details 


Administrative users are authenticated via 
PAM (and possibly eDirectory) and authorized 
access if they have write rights to the 
configuration file in the product directory (/ 
var/lib/qfsearch). 
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Access to information is controlled Yes Access to the administrative interface is 
restricted to valid users that have write rights 
to the configuration file in the product 
directory. 


Rights-based search results can be restricted 
to those that have rights to view them based 
on the following: 


+ The files or index are identified as public. 
or 


They are a valid user. 


+ The index is specified as rights- 
controlled at the index level and the user 
has rights to read the index control file. 


or 


The index is specified as rights- 
controlled at the file or path level and the 
user has rights to read the file or the path 
that contains that file. 


Roles are used to control access No 


Logging and/or security auditing is done Yes QuickFinder keeps log files containing the 
logged-in users’ UserIDs and the incoming IP 
address. However, the UserlDs are not 
exposed in the summary reports that are 
generated. Administrators can create their 
own exports that expose the UserlDs and IP 
addresses. 


Data on the wire is encrypted by default Yes The following data is encrypted on the wire: 


+ QuickFinder administration via browser 
UI. 


+ When logging in (if the administrator 
specified switching to the HTTPS 
protocol). 


+ When crawling HTTPS-based Web sites. 


+ When synchronizing QuickFinder 
indexes, configuration settings, and 
templates to other QuickFinder servers 
in a server farm (if the administrator 
specified to use the HTTPS protocol). 


+ Any time the user switches the browser's 
URL to use the HTTPS protocol. 


+ If crawling a password-protected Web 
site, but not using the HTTPS protocol, 
then UserlDs and passwords might be 
passed in the clear. 


Data stored is encrypted No 
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Passwords, keys, and any other No QuickFinder stores the credentials needed to 

authentication materials are stored crawl password-protected Web sites in its 

encrypted configuration files. These files are stored in 
the product directory (which should be 
protected). 


Both the UserID and the Password are visible 
if using the Form-based login method when 
crawling a Web site. The password is not 
visible in the UI when using the Basic 
Authentication method to access password- 
protected Web sites. 


Security is on by default Yes 


Security Characteristics 


QuickFinder Server communicates using port 80 for normal searches, port 443 for rights-based 
searches and to log in (controllable by the administrator). QuickFinder also uses port 443 for 
administration (controllable by the administrator). QuickFinder Server's Highlighter and Print 
servlets can use whatever port a URL was originally crawled on. 


When crawling a Web site, QuickFinder Engine uses port 80 for most Web sites and port 443 for most 
HTTPS-based Web sites. However, the actual ports are controlled by each Web site administrator. If a 
Web site is password-protected, user credentials can be configured by the search administrator when 
he or she defines the indexes. These credentials are sent with the URLs requested. 


When indexing a File System, the QuickFinder Server engine only indexes what it has rights to see. 
On Linux, it has rights to only the files that the novelwww user (within the www group) has rights to 
see. QuickFinder cannot control what user is used to run QuickFinder Server; it simply runs with 
whatever user the Tomcat servlet engine was launched with. QuickFinder also adds the novelwww 
user to the shadow group, which allows QuickFinder Server and QuickFinder Engine to determine if 
a user is a valid user through PAM. 


When synchronizing indexes, configuration settings, and search templates between QuickFinder 
servers, QuickFinder Server uses either port 80 or port 443,when communicating, controlled by the 
administrator. Administrators can also optionally configure the synchronization to require 
administrator credentials and HTTPS communications. 


Anyone that logs in as a valid user via PAM (possibly eDirectory) and has write rights to the specified 
qfind.cfg file (/var/lib/qfsearch/Sites/qfind.cfg) can administer QuickFinder. 


QuickFinder Server was originally designed to be capable of hosting search services for multiple 
independent organizations (possibly completely different enterprises). After an administrator has 
gained entry to QuickFinder Manager (through the specific virtual search server he or she has rights 
to), he or she then has administrative rights to all of the other virtual search servers. 


On the searching side, QuickFinder Server does not usually perform rights-based searching. 
However, using QuickFinder Manager, administrators can configure any index to restrict access to 
the search results within it (only the ability to see results on the search results pages, not access to 
them). After an administrator has configured an index to perform rights-based searching, 
approximately the same logic as for administering the product is performed: users are authenticated 
by PAM (possibly eDirectory) and individual files are authorized based on users’ individual read 
rights to various files in the file system. 
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Securitv Configuration 


The following sections provides a summary of securitv-related configuration settings for 


QuickFinder: 


+ Section 15.3.1, “QuickFinder Configuration Settings,” on page 182 


e Section 15.3.2, “Configuration Settings for Other Products,” on page 185 


QuickFinder Configuration Settings 


The following table lists the QuickFinder configuration settings that are security-related or impact 


the security of QuickFinder. 


Table 15-2 QuickFinder Security Configuration Settings 


Configuration Setting 


QFind.cfg > MsgDetail 


QFind.cfg > AutoTimeOut 


QFind.cfg > CheckRights 


QFind.cfg > 
CheckRightsFilePath 


QFind.cfg > CheckRightsFilter 


QFind.cfg > UserID 


QFind.cfg > Password 


QFind.cfg > AuthFields 


QFind.cfg > LoginURL 


QFind.cfg > HTTPHeaders 


QFind.cfg > IndexLocation 


Possible Value 


“Level of detail in indexing logs:” 
-1 through 5 


“Maximum query duration 
(seconds).” 
Any integer. 


“Authorization checking:” 
Off | Index | Resultitem 


“by Index (Only users that have 
read access to the following file 
have access to the index)” 

Any string value 


“Unauthorized hits filtered by” 
Engine | Templates 


“Basic Authentication: User ID“ 
Any string value 


“Basic Authentication: Password“ 


Any string value 


“Form-based Authentication” 
fields 
Any string value 


“Alternate Login URLs” 
Any string value 


“HTTP Headers:” 
any string value 


“Location of index files:” 
Any directory in the file system 
Any string value 
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Default Value 


30 seconds 


Off 


Points to / 
docs/ 
index.html 


Engine 


un 


un 


un 


un 


un 


<qfsearch>/ 
Sites/<VSS 
name>/ 
indexes/<index 
name> 


Recommended 
Value for Best 
Security 


5 


15 


Resultitem 


A file that is 
more rights- 
controlled 


Engine 
If possible, crawl 


public only. 


If possible, crawl 
public only. 


If possible, crawl 
public only. 


If possible, crawl 
public oniv. 


un 


Any directory 
that is secured. 


Configuration Setting 


QFind.cfg > CanBeMirrored 


AdminServlet.properties > 
AdminServlet.RequireSSL 


AdminsServlet.properties > 
AdminServlet. Authenticate 


AdminServlet.properties > 


AdminServlet.ProductUpdates.E 


nabled 


AdminServlet.properties > 


AdminServlet.ProductUpdates.U 


RL 


GeneralServlet.Errors.Enabled 


QueryLog.Enabled 
ClusterServices.Log. Enabled 


GeneralServlet.Errors.Destinatio 


n 


ClusterServices.Log.Destination 


GeneralServlet.Errors.LogFile.D 


eleteOnRestart 


ClusterServices.Log.DeleteOnR 


estart 


GeneralServlet.Errors.LogFile.M 


axSize 
ErrorLog.MaxSize 
ClusterServices.Log.MaxSize 


GeneralServlet.properties > 
GeneralServlet.Mail.Enabled 


GeneralServlet.properties > 


GeneralServlet.Mail. SMTP Host 


GeneralServlet.properties > 


GeneralServlet.Mail.SMTPPort 


GeneralServlet.properties > 


GeneralServlet.Mail.SMTPUserl 


D 


Possible Value 


“Index may be copied to other 
clustered servers:” 
true | false 


“Require HTTPS when 
administering QuickFinder 
Server:” 

true | false 


“Require authorization when 
administering QuickFinder 
Server:” 

true | false 


“Check for product updates:” 
true | false 


Not in UI 
Any string value 


“Log Enabled” 
true | false 


“Log to:” 
File | Console | Both 


“New log when services load:” 
true | false 


“Maximum log size (bytes):” 
Any positive integer 


“Enable e-mail services:” 
true | false 


“Outgoing SMTP Host name:” 
Any string value 


“Outgoing SMTP Port #:” 
Any positive integer 


“Outgoing SMTP User ID 
(optional):” 
Any string value 


Default Value 


FALSE 


TRUE 


TRUE 


TRUE 


http:// 
search.novell.c 
om/qfsearch/ 
UpdateServlet 


TRUE 


Both 


TRUE 


30000 


FALSE 


un 


25 


un 


Recommended 
Value for Best 
Security 


FALSE 


TRUE 


TRUE 


FALSE 


un 


TRUE 


Both 


FALSE 


30000 


TRUE 


The name of the 
local SMTP mail 
server. 


The correct port 
of the local 
SMTP server. 


The UserID of 
the local SMTP 
mail server. 
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Configuration Setting 


GeneralServlet.properties > 
GeneralServlet.Mail.SMTPPass 
word 


Cluster. properties > 
ClusterServices.Send.Enabled 


Cluster. properties > 
ClusterServices.Receive.Enable 
d 


Cluster.properties > 
ClusterServices.RequireHTTPS 


Cluster. properties > 
ClusterServices.Authentication. 
RequireAuthentication 


SiteList.properties > 
SiteList.GlobalSite 


SiteList.properties > 
Monitor.SiteCache.DynamicUpd 
ates 


SiteList.properties > 
Monitor. TemplateCache.Dynami 
cUpdates 


General.properties > 
Monitor.SiteCache.PurgeSiteSe 
conds 


General.properties > 
QueryLog.Mail.Enabled 


General.properties > Recipients 


General.properties > 
Site.Cluster.Send.Enabled 


General.properties > 
Site.Cluster.Send.ClusterNames 


General.properties > 
Site.Cluster.Receive.Enabled 


General.properties > 
Response.PotentialHits.Max 


Possible Value 


“Outgoing SMTP Password 
(optional):” 
Any string value 


“Will this machine send cluster 
data:” 
true | false 


“Will this machine receive cluster 
data:” 
true | false 


“Require HTTPS for all cluster 
communications:” 
true | false 


“Require admin authorization 
when receiving cluster data:” 
true | false 


“Default location of virtual search 
servers:” 
Any string value 


“Detect manual search server 
changes:” 
true | false 


“Detect template changes:” 
true | false 


Not in UI 
Defaults to 20 minutes 
Any non-negative integer 


“E-mail log reports:” 
true | false 


“enter recipients...” 


“Let Virtual Search Server send 
cluster data:” 
true | false 


“Name of clusters to send to:” 
Any string value 


“Let Virtual Search Server receive 
cluster data:” 
true | false 


“Refuse queries if potential hits 
exceed:” 
Any positive integer. 
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Default Value 


un 


FALSE 


TRUE 


FALSE 


TRUE 


<QFSearch>/ 


sites 


TRUE 


TRUE 


1200 


FALSE 


un 


FALSE 


un 


FALSE 


10000 


Recommended 
Value for Best 
Security 


The password of 
the local SMTP 
mail server. 


FALSE 


FALSE 


TRUE 


TRUE 


A protected file 


system location. 


FALSE 


FALSE 


60 


FALSE 


un 


FALSE 


un 


FALSE 


5000 


15.3.2 


Configuration Setting 


Search.properties 2 
Print.properties 2 
Search.Request.NumHits.Max 
Search.BestBet.NumHits.Max 
Print. Request.NumHits.Max 


Search.properties 2 
Print.properties 2 
Search.Request.LastHitNum.Ma 
x 
Print.Request.LastHitNum.Max 


Search.properties > 
Print.properties > 

Search. Templates.Directory 
Print. Templates. Directorv 
Highlighter.Templates.Directory 


Print.properties > 
Print.Response.PrintSize.Warnin 
g 


Print.properties 2 
Print. Response. PrintSize.Max 


Securitv.properties 2 
Security.Authentication.RealmStr 
ing 


Security.properties > 
Security.LoginType 


Security.properties > 
Security. CheckRightsByDir 


Security.properties > 
Security. AutoLogoutTime 


Security.properties > 
Security.RequireHTTPS 


Possible Value 


“Maximum number of results per 
page:” 

Any positive integer up to 
“Highest allowed result number:” 


“Highest allowed result number:” 
Any positive integer 


“Templates directory:” 
Any string value 


“Print job size warning (bytes):” 
Any positive integer 


“Maximum print job size (bytes): 
Any positive integer 


“Authentication realm string:” 
(Only used if LoginType is set to 
basic, 0) 

Any string value 


Not in Ul 
O - login type basic 
1 - login type form 


“Check authorization by 
directory:” 
true | false 


“Auto-logout time (minutes):” 
Any positive integer 
-1 == never log out 


“Require https:” 
true | false 


Configuration Settings for Other Products 


The following table lists the configuration settings for other products that impact the security of 


QuickFinder. 
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Default Value 


200 
5 
200 


1000 
1000 


<qfsearch>/ 
Templates 


102400 


2097152 


“QuickFinder 
Server” 


TRUE 


30 


TRUE 


Recommended 
Value for Best 
Security 


100 
5 
25 


A rights- 
controlled 
directory. 


40960 


512500 


Best if it matches 


the Web server’s 
realm. 


FALSE 


TRUE 
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Table 15-3 Configuration Settings for Other Products 


Product Configuration Setting Default Value Recommended Value for 

Name Best Security 

PAM Rights to the shadow group on Not made a member of this Not made a member of this 
Linux group. group, but requires that 


eDirectory is installed. 


15.4 Other Security Considerations 


+ Servers should be kept in a physically secure location with access by authorized personnel only. 


¢ The corporate network should be physically secured against eavesdropping or packet sniffing. 
Any packets associated with the administration of QuickFinder should be the most secured. 


+ Access to QuickFinder indexes, configuration settings, and logs should be restricted. This 
includes file system access rights, FTP access, access via Web utilities including QuickFinder 
Manager, and any other type of access to these files. 


+ Configuration settings that serve to send QuickFinder data to other servers or e-mail accounts or 
that protect QuickFinder data should be examined periodically to ensure that they have not 
been tampered with. 


+ When synchronizing QuickFinder indexes, configuration settings, or templates to servers 
outside the corporate firewall, both QuickFinder Authentication and the HTTPS protocol should 
be employed (see “Modifying Administrator Authentication Settings” on page 49). Because this 
ultimately sends the entire QuickFinder configuration of a server to another server, great 
security precautions should be taken. 


+ When QuickFinder is administered by users outside of the corporate firewall, both QuickFinder 
Authentication and the HTTPS protocol should be used. A VPN should also be employed. 


+ Ifa server is accessible from outside the corporate network, a firewall should be employed to 
prevent direct access by a would-be intruder. 


¢ Audit logs and query reports should be kept and analyzed periodically. 


¢ Previous versions of QuickFinder stored username and passwords in config files. After updating 
to QuickFinder 5.0, the username and passwords are still stored in the config files until the 
config file is updated. At that point, the passwords are moved to CASA. Until they are moved to 
CASA, users who gain access to the qfind. cfg file can use the specified UserIDs and passwords 
to access those sites themselves. 


+ A memory walker could discover usernames and passwords. If a user somehow has access to 
the server and could manipulate the memory, he or she could possibly get the passwords 
because passwords are not immediately cleared from memory or obfuscated in any way. 


+ Usernames and Passwords are stored in CASA by using the Tomcat user. Other applications 
running in Tomcat, or users that know the Tomcat user credentials, could potentially get the 
usernames and passwords for the remote servers. In order to take advantage of this, an 
application needs to be installed as an Apache application and then specifically call CASA with 
the correct ID to get the passwords. 


+ Although a QuickFinder Manager administrator might not have access rights to the entire 
server, QuickFinder Engine’s File System repository and indexer might. The QuickFinder 
administrator can generate an index of the entire server, then see the first 255 bytes of the file 
(search descriptions). 


+ Users might try to gain access to the index files. If a very sophisticated user properly decompiles 
the indexes, he or she might be able to discover the structure of the indexed files and rebuild the 
content of the files. An administrator should know where the index files are stored and what 
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permissions are granted to those index files. An administrator should also be aware that an 
index file stored on a file system that is actually a remote mount might expose the index files to 
the security vulnerabilities of that remote mounted file system. For example, if the remotely 
mounted file system uses unsecured NES, a network listener could listen for the packets on the 
network and reassemble the index or simply do a remote mount as the Apache user with no 
authentication required. Even users who cannot rebuild the contents of the files can still see the 
first 255 relevant text bytes by simply performing searches and reading the descriptions. To the 
best of our knowledge, even if users have access to the index (and the index format spec), they 
would still have a very difficult time rebuilding the file contents. 
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Troubleshooting QuickFinder 


This section provides some troubleshooting topics that can help vou resolve search and print 
performance issues. It offers possible causes for issues vou might encounter, as well as suggested 
actions for resolving them. 


If the problem vou are working with doesn't appear in this section, visit the Novell Support Web site 
(http://www.novell.com/support). 


+ 


+ 


+ 


“On Failure of Index Optimization” on page 189 

“On Failure of Synchronization, Indexing Fails in a Cluster Environment” on page 189 
“Characters of descriptions or titles appear as unintelligible characters” on page 189 
“Several titles or descriptions contain the same text” on page 190 

“Some titles are returned as the URL of the document instead” on page 190 

“QuickFinder Admin Login Fails Consecutively” on page 190 

“Indexing Fails on NSS Volumes” on page 191 

“Losing Registry Information After an Upgrade From OES 2 SP2 to OES 2 SP3” on page 192 


On Failure of Index Optimization 


Possible Cause: Increased data when updating/optimizing the index. 


Action: Regenerate the index. It should resolve the issue. It is recommended to do the 
following to avoid the problem in future. 


1 Schedule the index for update/optimize more frequently, for example, 
update once a day and optimize once or twice a week. 


2 If the size of the data to be indexed is more, split the single index into 
multiple small indexes. This helps in getting the index generation/ 
optimization quickly. 


On Failure of Synchronization, Indexing Fails in a Cluster Environment 


Possible Cause: One of the server is down in the QuickFinder cluster setup causing failure of 


indexing. This results in the failure of the search task. 


Action: Ensure all the servers are up and running in the cluster environment, then 
perform indexing. 


Characters of descriptions or titles appear as unintelligible characters 


Possible Cause: You've probably indexed documents written in multiple languages and 
encodings. QuickFinder can index most of the world's languages and encodings. 


However, QuickFinder needs to know the encoding of each document. 
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Possible Cause: Some of your documents were probably not tagged with an encoding or were 
incorrectly tagged. 


Action: Make sure all of your documents contain the correct Content-Type meta tag. If 
your international documents do not contain a Content-Type meta tag, either 
add it or use the Encoding (If Not in META Tags) index definition option to specify 
the default encoding. 


For more information, see Chapter 14, “Internationalizing Search Services,” on 
page 171. 


Several titles or descriptions contain the same text 


Possible Cause: If search results include duplicate titles or descriptions, your description fields 
(description, summary, or abstract) might include boilerplate information (that 
is, standardized information repeated in multiple locations.). 


Action: The more accurate your meta tag description fields are, the better your search 
results are. Where possible, consider adding descriptions to your document's 
meta tags. 


Possible Cause: It could also be that you have indexed the same document more than once, or 
several links throughout your Web site might point to the same document but do 
so using different character cases each time. 


Action: To solve the latter problem, try using the URLs Are Case Sensitive option to direct 
QuickFinder to turn off case-sensitive crawling. Also, remove any duplicate 
backup files you might have and exclude any backup directories from your 
index definition. 


Some titles are returned as the URL of the document instead 


Possible Cause: QuickFinder pulls document titles from within each document that it indexes. If 
your document doesn't have a title, QuickFinder uses the URL or path of the 
document instead. If the URL is unavailable, a Title Unavailable message is 
returned. 


Action: Make sure all of the documents you index have specifically defined titles. 


QuickFinder Admin Login Fails Consecutively 


Possible Cause: You have given incorrect credentials for login. The consecutive attempt to login 
fails if in the initial attempt you have specified the username in upper case, and 
the login failed. For example, if the username is test and the password is testing, 
and you specified the username in a different case, such as TEST, the login fails. 


Action: When your login with upper case admin name and password failed, perform 
either of the following; 


+ Run the Quickfinder setup from YAST again and reconfigure the 
Quickfinder. Clean the cookies from the browser and login to the Admin 
console. 


+ Run the Admin setup command as given below with the password set in 
QF ADMIN PWD variable on the console. Then restart Tomcat and apache. 


OES 11 SP2: Novell QuickFinder Server 5.0 Administration Guide 


/var/lib/qfsearch/bin/create-admin-user.sh 2 'admin' 
'o=novell' 'o-novell' 
'cn-admin,o-novell' 


Clean the cookies from the browser and login to the Admin console. 


Indexing Fails on NSS Volumes 


Explanation: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


When the DNS (novell-named) service fails to start, the following error is 
encountered and is logged into /var/opt /novell/log/named/named. run file: 


dns/db: critical: NWCallsInit failed with error code:-1 


LUM is not configured properly, and the novlxsrvd and novlxtregd LUM users 
do not exist in the eDirectory as members of both the novlxtier and wwwrun 
groups. 


Perform the following steps: 


1 Reconfigure LUM 


2 Ensure LUM users exist in eDirectory, by running namuserlist novlxregd 
and namuserlist novlxsrvd from the command line. 


3 View the status of xregd user by entering the command: 
renovell-xregd status 
If the xregd user is not running, enter rcnovell-xregd start command. 


If novell-named service fails to start even after performing the above 
procedure, then the files in the xtier registry might not be generated properly. 


To verify the existence of registry content perform from step 7 to step 9 of the 
below procedure. If the content in the respective directories as mentioned in step 
9 does not exist, perform the following steps to rebuild the xtier registry: 


1 Open the terminal console and stop the xregd user by entering the 
following command: 
renovell-xregd stop 


2 Navigate to /var/opt/novell/xtier/xregd/db/ and enter 1s -1 to 
verify that the folder db is empty. If the folder is empty, continue with step 4. 


3 If any files exist inside the db folder, move all the files to the temporary 
folder, for example /tmp. 


4 Generate files inside the xtier registry by using the following command: 


/opt/novell/xtier/bin/regutil -i /etc/opt/novell/xtier/ 
xtier registrv.xml 


5 Navigate to /var/opt /novell/xtier/xregd/db/ and ensure that the 
following files are generated: 


xtier registry.db 


xtier registrv.lck 





xtier registrv.rfl 

6 Start the xregd user by entering the following command: 
renovell-xregd start 

7 Navigate to the xtier registry by using the following command: 
/opt/novell/xtier/bin/regedit 
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8 At the regedit prompt, execute the cd local machine command and enter 
the 1s -1 command to view the content inside the directory. If the folder 
software is present in the local machine directory, then the registry is 
rebuilt without any error. 


9 Similarly, enter the following commands in the listed sequence and enter 
the 1s -1 command to view the content in the respective directories: 


cd software 
cd Novell 
cd Xtier 


cd Configuration 


registry: tt cd local machine 
registrjp://local machine # ls -1 

software 
registry://local_machine # cd software 
registry://local_machine/software # 1s -1 

Novell 
registry://local_machine/software # cd Novell 
registry://local_machine/software/Novell # 1s -1 

XTier 

Client 
registry://local_machine/software/Novell # cd XTier 
registry://local_machine/software/Novell/xXTier # 1s -1 

Configuration 

Policies 
registry://local_machine/software/Novell/xTier # cd Configuration 
registry://local_machine/software/Novell/xXTier/Configuration # Is-1 

MapDay 

XDau 

XSyncNsp 

XSru 

XTLOG 

XTCIFS 

CifsDav 

XTSOAP 





If the content exist in all the respective directories, then the xtier registry is 
completely rebuilt. 


10 Enter exit. 
11 Restart the machine. 


Losing Registry Information After an Upgrade From OES 2 SP2 to OES 2 SP3 


Explanation: At times, after an upgrade from OES 2 SP2 to its latest support pack (SP3), the 
registry information is either lost or corrupted. 


Action: Back up the registry before an upgrade and restore it. For more information, see 
“Losing Registry Information After an Upgrade From OES 2 SP2 to OES 2 SP3” 
in the OES 11 SP2: NetStorage Administration Guide for Linux. 
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Combined Character Sets for Use 
with QuickFinder 


The following tables list the character set encoding names and aliases that QuickFinder recognizes 
when indexing, searching, displaving, or printing files. This information is a subset of the character 


names registered by the Internet Assigned Numbers Authority (IANA). 


Whenever possible, the items listed in the first column of each table are the preferred MIME names 


listed in the Internet Assigned Numbers Authority (IANA) Character Sets registry. If a preferred 
MIME name is not available, items in the first column represent the primary registered names. 


Items in the second column of each table are aliases that are sometimes used to identify that 


encoding. 


Not all aliases exactly represent the parent encoding under which they are listed. In these cases, they 


overlap significantly enough to be handled identically by the various QuickFinder engines. 





TIP: Character encodings appear in the exact case specified in the Internet Assigned Numbers 


Authority (IANA) Character Sets registry (http://www.iana.org/assignments/character-sets). Some 
uses of these encodings are case sensitive. However, QuickFinder ignores the case of these encodings. 





+ Section B.1, “ASCII Character Set,” on page 194 

+ Section B.2, “Arabic Character Set,” on page 195 

+ Section B.3, “Chinese (Simplified) Character Set,” on page 195 
+ Section B.A, “Chinese (Traditional) Character Set,” on page 196 
+ Section B.5, “Cyrillic Character Set,” on page 197 

+ Section B.6, “European Character Set,” on page 198 

+ Section B.7, “Greek Character Set,” on page 201 

+ Section B.8, “Hebrew Character Set,” on page 202 

+ Section B.9, “Japanese Character Set,” on page 202 

+ Section B.10, “Korean Character Set,” on page 203 

+ Section B.11, “Thai Character Set,” on page 204 

+ Section B.12, “Turkish Character Set,” on page 205 


+ Section B.13, “Vietnamese Character Set,” on page 205 
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B.1 ASCII Character Set 


Table B-1 ASCII Character Set 


Preferred MIME Name or Primarv Registered 


Name Encoding Names 


US-ASCII (MIBenum: 3) ANSI X3.4-1968 
A MIBenum is a record number corresponding to ANSI X3.4-1986 
an entry in IANA's Management Information Base. 
ASCII 
ascii7 
iso_646-us 
ISO646-US 
ISO_646.irv:1991 
iso-ir-6 
646 
us 
IBM367 
cp367 
csASCII 
IBM437 (MIBenum: 2011) ibm-437 
cp437 
437 


csPC8CodePage437 
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B.2 


B.3 


Arabic Character Set 
Table B-2 Arabic Character Set 


Preferred MIME Name or Primarv Registered 
Name 


ISO-8859-6 (MIBenum: 9) 


A MIBenum is a record number corresponding to 
an entrv in IANA's Management Information 
Base. 


Windows-1256 (MIBenum: 2256) 


Encoding Aliases 


ISO 8859-6:1987 
ISO 8859-6 
iso8859-6 
iso8859_6 
8859 6 

IBM1089 
ibm-1089 

cp1089 

1089 

iso-ir-127 
ECMA-114 
ASMO-708 
arabic 
csISOLatinArabic 
cp1256 

win1256 


ms1256 


Chinese (Simplified) Character Set 


Table B-3 Chinese (Simplified) Character Set 


Preferred MIME Name or Primary Registered 
Name 


gb2312 (MIBenum: 2025) 
gb 2312-80 (MIBenum: 57) 


A MIBenum is a record number corresponding to 
an entrv in IANA's Management Information Base. 


Encoding Aliases 


csGB2312 

iso-ir-58 

chinese 
csISO58GB231280 
gb2312-80 
gb2312-1980 
gb-2312-80 
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B.A 


Preferred MIME Name or Primarv Registered 
Name 


gbk 


euc-cn 


Encoding Aliases 


GBK 
windows-936 
ms936 
cp936 
cp-936 
EUC_CN 
euccn 


euc-gb 


Chinese (Traditional) Character Set 


Table B-4 Chinese (Traditional) Character Set 


Preferred MIME Name or Primary Registered 
Name 


big5 (MIBenum: 2026) 


A MIBenum is a record number corresponding to 
an entry in IANA's Management Information 
Base. 


IBM950 


Encoding Aliases 


Big5 
windows-950 
win950 
ms950 
csBig5 
ibm-950 
cp950 
cp-950 

950 
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B.5 


Cvrillic Character Set 
Table B-5 Cyrillic Character Set 


Preferred MIME Name or Primary Registered 
Name 


ISO-8859-5 (MIBenum: 8) 


A MIBenum is a record number corresponding to 
an entry in IANA's Management Information Base. 


KOI8-R (MIBenum: 2084) 


Windows-1251 (MIBenum: 2251) 


Combined Character Sets for Use with QuickFinder 


Encoding Aliases 


ISO 8859-5:1988 
ISO 8859-5 
iso8859-5 
iso8859 5 
8859-5 

iso-ir-144 

IBM915 

ibm-915 

cp915 

915 

cyrillic 
cslSOLatinCyrillic 
koi8_r 

koi8 

cp878 

cp-878 

csKOI8R 
win1251 

cp1251 


ms1251 
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B.6 European Character Set 


Table B-6 European Character Set 


Preferred MIME Name or Primarv Registered 


Name Encoding Aliases 


Windows-1252 (MIBenum: 2252) cp1252 

A MIBenum is a record number corresponding to ms1252 

an entrv in IANA's Management Information 

Base. win1252 
ansi 
ansi-1252 

ISO-8859-1 (MIBenum: 4) ISO 8859-1:1987 
ISO 8859-1 
iso8859-1 
iso8859 1 
8859 1 
iso-ir-100 
IBM819 
ibm-819 
CP819 
819 
11 
latin1 


csISOLatini 
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Preferred MIME Name or Primarv Registered 
Name 


ISO-8859-2 (MIBenum: 5) 


A MIBenum is a record number corresponding to 
an entrv in IANA's Management Information 
Base. 


ISO-8859-3 (MIBenum: 6) 


Encoding Aliases 


ISO 8859-2:1987 
ISO 8859-2 
iso8859-2 
iso8859 2 
8859 2 
iso-ir-101 
IBM912 
ibm-912 
cp912 

912 

12 

latin2 
csISOLatin2 
ISO 8859-3:1988 
ISO 8859-3 
iso8859-3 
iso8859 3 
8859-3 
iso-ir-109 
IBM913 
ibm-913 
cp913 

913 

13 

latin3 


csISOLatin3 
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Preferred MIME Name or Primarv Registered 


Name Encoding Aliases 


ISO-8859-4 (MIBenum: 7) ISO 8859-4:1988 
ISO 8859-4 
iso8859-4 
iso8859_4 
8859-4 
iso-ir-110 
IBM914 
ibm-914 
cp914 
914 
14 
latina 
csISOLatina 

Windows-1250 (MIBenum: 2250) cp1250 
ms1250 
win1250 

IBM850 (MIBenum: 2009) (UNICODE) ibm-850 
cp850 
850 
csPC850Multilingual 

IBM852 (MIBenum: 2010) ibm-852 
cp852 
852 
csPCp852 

IBM860 (MIBenum: 2048) ibm-860 
cp860 
860 
csIBM860 

IBM863 (MIBenum: 2050) ibm-863 
cp863 
863 


csIBM863 
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B.7 


Preferred MIME Name or Primarv Registered 
Name 


IBM865 (MIBenum: 2052) 


Greek Character Set 


Table B-7 Greek Character Set 
Preferred MIME Name or Primarv Registered 


Name 


ISO-8859-7 (MIBenum: 10) 


A MIBenum is a record number corresponding to 
an entrv in IANA's Management Information 
Base. 


Windows-1253 (MIBenum: 2253) 


Encoding Aliases 


ibm-865 
cp865 
865 


csIBM865 


Encoding Aliases 


ISO 8859-7:1987 
ISO 8859-7 
iso8859-7 
8859 7 

IBM813 

ibm-813 

cp813 

813 

iso-ir-126 

ELOT 928 
ECMA-118 

greek 

greek8 
csISOLatinGreek 
cp1253 

ms1253 


win1253 
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B.8 


B.9 


Hebrew Character Set 
Table B-8 Hebrew Character Set 


Preferred MIME Name or Primarv Registered 
Name 


ISO-8859-8 (MIBenum: 11) 


A MIBenum is a record number corresponding to an 
entry in IANA's Management Information Base. 


Windows-1255 (MIBenum: 2255) 


Japanese Character Set 


Table B-9 Japanese Character Set 


Preferred MIME Name or Primary Registered 
Name 


Encoding Aliases 


ISO 8859-8:1988 
ISO 8859-8 
iso8859-8 
8859 8 

ibm916 

ibm-916 

cp916 

916 

iso-ir-138 

hebrew 
csISOLatinHebrew 
win1255 

cp1255 


ms1255 


Encoding Aliases 


ISO-2022-JP (MIBenum: 39) iso2022-jp 


A MIBenum is a record number corresponding to iso-2022-jis 


an entrv in IANA's Management Information 


Base. junet 


jis 


jis encoding 


csJISEncoding 


csISO2022JP 


ISO-2022-JP-2 (MIBenum: 40) iso-2022-jp2 


csISO2022JP2 
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B.10 


Preferred MIME Name or Primarv Registered 
Name 


Shift JIS (MIBenum: 17/2024) 


EUC-JP (MIBenum: 18) 


Korean Character Set 
Table B-10 Korean Character Set 


Preferred MIME Name or Primarv Registered 
Name 


euc-kr (MIBenum: 38) 


A MIBenum is a record number corresponding to 
an entrv in IANA's Management Information Base. 


Encoding Aliases 
sjis 

shift-jis 

ShiftJis 

x-sjis 

x-shift-jis 
windows-31j 
csWindows31J 
ms932 

cp932 

win932 
windows-932 
MS_Kanji 
csShiftJIS 

pck 


1u30b71u30d5lu30c8lu7b26lu53f/11u53161u8868lu73f 
e 


Extended UNIX Code Packed Format for Japane 
se 





eucjp 

x-euc-jp 

euc jpnew 10/18/99 
x-eucjp 

eucjis 


csEUCPkdFmtJapanese 


Encoding Aliases 


euc_kr 
euckr 


csEUCKR 
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Preferred MIME Name or Primarv Registered 


Name Encoding Aliases 


ks c 5601-1987 (MIBenum: 36) ks c 5601-1989 
ksc5601-1987 
ksc5601 1987 
ksc 5601 
ksc5601 
5601 
korean 
csKSC56011987 
IBM949 ibm-949 
cp949 
cp-949 
949 
Windows-949 win949 


ms949 


B.11 Thai Character Set 


Table B-11 Thai Character Set 


Preferred MIME Name or Primary Registered Encoding Aliases 


Name 

IBM874 ibm-874 
cp874 
874 

Windows-874 win874 
ms874 
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B.12 


B.13 


Turkish Character Set 


Table B-12 Turkish Character Set 


Preferred MIME Name or Primarv Registered 
Name 


ISO-8859-9 (MIBenum: 12) 


A MIBenum is a record number corresponding to 
an entrv in IANA's Management Information Base. 


Windows-1254 (MIBenum: 2254) 


Vietnamese Character Set 


Table B-13 Vietnamese Character Set 


Preferred MIME Name or Primary Registered 
Name 


Windows-1258 (MIBenum: 2258) 


A MIBenum is a record number corresponding to 
an entry in IANA's Management Information 
Base. 


Encoding Aliases 


ISO 8859-9:1989 
ISO 8859-9 
iso8859-9 
8859 9 
ibm920 
ibm-920 
cp920 

920 
iso-ir-148 

I5 

latin5 
csISOLatin5 
win1254 
cp1254 


ms1254 


Encoding Aliases 


win1258 
ms1258 
cp1258 

cp-1258 
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Disabling QuickFinder Server 


This section contains information on disabling QuickFinder Server on Novell Open Enterprise Server 
(OES) 11 SP2. 


+ Section C.1, “Disabling QuickFinder Server,” on page 207 
* Section C.2, “Consequences of Disabling QuickFinder Server,” on page 207 


C.1 Disabling QuickFinder Server 


1 Delete the symbolic link /var/opt/novell/tomcaté-32bit/webapps/qfsearch. 
2 To restart Tomcat, run 
rcnovell-tomcat6-32bit restart 


This removes the QuickFinder registration with Tomcat, and QuickFinder no longer loads. 


C.2 Consequences of Disabling QuickFinder Server 


¢ Disabling QuickFinder Server does not effect any OES 11 SP2 service except those using search. 


+ Clicking the QuickFinder link in iManager results in an error. 
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QuickFinder Packages (RPMs) 


The following table provides information about the Linux packages that are included with 


QuickFinder: 


Table D-1 QuickFinder RPMs 


Package (RPM) 


quickfinder-engine 


quickfinder-server 


quickfinder-api 


novell-quickfinder 


Description 


Main QuickFinder capabilities, raw engine, all file readers and 
repositories. No user interface. 


Web-accessible Java servlet-based interface to the QuickFinder 
Engine. Provides additional features, such as stop words, redirection, 
admin, speller, off-site URLs, templates, svnchronization, rights-based 
searching, synonyms, search expansion, multi-file printing, highlighter, 
Best Bets, and e-mail integration. 


C# interface into the QuickFinder engine, and a port of some of the Java 
add-ons. 


Configures the QuickFinder engine and server for the Novell Open 
Enterprise Server Tomcat/Apache environment. 
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E.1 


E.2 


QuickFinder Server Tips and Tricks 


This section offers tips and tricks for optimizing the management of QuickFinder. 


+ Section E.1, “Crawler Sits a Long Time On a URL, Then Fails After 9 Minutes,” on page 211 
+ Section E.2, “Synchronizing Indexes Takes a Very Long Time,” on page 211 
+ Section E.3, “Indexing an NSS Volume,” on page 212 


+ Section E.4, “The Crawled Index is Taking a Long Time to Generate; I Want to Know What's 
Going on, But Don't Want to Cancel It and Lose Everything,” on page 212 


+ Section E.5, “Failed Indexes,” on page 212 

+ Section E.6, “Rights-based Searching,” on page 212 

¢ Section E.7, “XML Search Reports,” on page 213 

+ Section E.8, “Dynamic Index Weights - One of the Best New Features,” on page 213 
+ Section E.9, “Getting Help,” on page 213 


Crawler Sits a Long Time On a URL, Then Fails After 9 
Minutes 


If QuickFinder encounters URLs which it cannot connect to (server is down, DNS servers are down, 
network is down, TCP/IP is down, etc.) it may hang for up to 3 minutes, then try again two more 
times, for a total of 9 minutes per failed URL. This situation is especially bad if customers include 1 or 
2 levels of “Off-Site” URLs because Web administrators rarely know where all of the off-site links 
point. 


The tcp_syn_retries setting allows admins to control the timeout value when making a connection 
to a remote site. This sets the maximum number of times initial SYNs for an active TCP connection 
attempt will be retransmitted. The value should not be higher than 255. The default value is 5, which 
corresponds to approximately 180 seconds. 


Did you catch that, 180 seconds! That's 3 minutes per attempt. Because QuickFinder automatically 
retries failed URLs on its own, it is best to set this value to 1, which corresponds to about 15 seconds 
per attempt. 


Synchronizing Indexes Takes a Very Long Time 


Any time you copy huge files from one machine to another, it takes a long time. Since QuickFinder 
uses the HTTP PUT protocol for security reasons to synchronize the indexes, it takes even longer. 
However, the part of the communications pipeline that takes the longest is the use of the HTTPS 
(SSL) protocol. We have found that indexes synchronize 10 times faster between machines if admins 
use the HTTP protocol which can be configured in the Global Synchronization Settings page. Besides, 
if the sending and receiving machines are already both behind the corporate firewall, then there's no 
need to have the added security. 
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E.3 


E.4 


E.5 


E.6 


Indexing an NSS Volume 


Make sure the Tomcat user (wwwrun) is a member of the www group and that both the www group 
and the wwwrun user are LUM-enabled. These steps happen during the install. However, the 
customer still needs to give the wwwrun user or the www group rights to read the NSS volume. To 
do this, use the rights program to grant trustee rights to the volume. 


The Crawled Index is Taking a Long Time to Generate; | 
Want to Know What's Going on, But Don't Want to Cancel It 
and Lose Evervthing 


QuickFinder has added a new “stop” feature in addition to the “cancel” feature on the View Active 
Jobs page. Unlike cancel, stop simply quits finding new files and makes indexes of what it has 
collected so far. That lets admins look at the indexing logs to see what is going on or what is going 
wrong. 


Failed Indexes 


Sometimes index generation fails. There could be a number of reasons for this, but customers have 
been substantiallv unable to determine the cause of the failure. 


To help resolve this issue, we added a new “View Log” button on the page where you can see a 
particular job running. Unlike the “View Log” button on the “Indexes Maintenance” page (which 
shows the crawled.log file), this “View Log” button shows the failed.log file. 


Rights-based Searching 


QuickFinder and Web Search have always been able to perform rights-based searching (showing 
only those hits that users have rights to see). However, if a particular user doesn't have rights to the 
first 100,000 files, then both take a long time to show any search results. Therefore, QuickFinder and 
Web Search both have the ability to define rights at several levels: 1) Individual files - very secure, but 
very slow; 2) Path-level access control - if a user has rights to the 1st search result in a particular 
directory, then they have rights to all the files in that directory; still sufficiently secure, but much 
faster; 3) Index level access control; if a user has rights to the “index control file”, then they have 
rights to see all the search results from that index; mild security, but very fast; under high load 
situations, this is the best choice, but requires that admins segregate their content into “public” and 
“protected” indexes. 
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E.7 


E.8 


E.9 


XML Search Reports 


QuickFinder defaults to using the ReportTemplate . html file when generating weekly or monthly 
query reports. However, if an admin wants QuickFinder to export all of the raw query details into an 
XML format, the admin needs to change the template name to ExportTemplate.xml (which is a 
sample XML export that admins could retrieve into more sophisticated reporting products or log 
analyzer products). 


You can also temporarily change the report template, highlight a desired date range from the 
Available log reports list box, then press Generate Current without clicking on the Apply button. This 
will use the specified report template name and date range to generate the report instead of the actual 
“applied” settings. 


Dynamic Index Weights - One of the Best New Features 


QuickFinder has added the ability to specify an “index weight” value on a query-by-query basis in 
addition to the “index weight” value defined as a default when configuring the index. The new 
syntax is: 


&index=indexNamel ; indexName2 : ###&index=indexName3 : ###; indexName4 


In other words, the &index= parameter can be sent multiple times; each occurrence can specify 
multiple indexes; and each index can include an optional weight value (:###). Weight values can 
range from 1 to 200. 


The importance of the new weight value should not be overlooked. Search admins can now choose to 
place emphasis on a particular index by boosting its index weight value w/o excluding other indexes 
from the search as they’ve had to do in the past. Yet on a different part of the web site, they may 
choose to boost another index from the list...but always searching the same indexes. In this manner, 
admins are no longer forced to eliminate “other” results by having users “select” the index to search 
in; they can now simply “emphasize” particular results as the needs may arise. Note that the new 
index weight values (:###) override the like-named defaults specified in the Index Definition. 


The new index weight values can be used with the following parameters: 


+ &index= 

¢ &collection= 

+ &bbindex= 

+ &bbcollection= 
+ &expandindex= 


+ &expandcollection= 


Getting Help 


One of the best ways to get help is to send an e-mail to the quickfinder@novell.com e-mail address 
(used to be websearch@novell.com). This will auto-forward to a number of engineers who are more 
than happy to help with any problems a customer may have. 
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F.1 


F.1.1 


F.2 


F.2.1 


Documentation Updates 


This section contains information about documentation content changes made to the QuickFinder 


Server 5.0 Administration Guide for Novell Open Enterprise Server 11. 
This document was updated on the following dates: 


¢ Section F.1, “January 17, 2013 (OES 11 SP1),” on page 215 
+ Section F.2, “April 30, 2012 (OES 11 SP1),” on page 215 


January 17, 2013 (OES 11 SP1) 


Updates were made to the following sections. The changes are explained below. 


Troubleshooting QuickFinder Server 5.0 


Location Change 


“On Failure of Index Optimization” on page 189 Added a new troubleshooting scenario. 


April 30, 2012 (OES 11 SP1) 


Updates were made to the following sections. The changes are explained below. 


+ Section F.2.1, “What's New or Changed in QuickFinder Server 5.0,” on page 215 


What's New or Changed in QuickFinder Server 5.0 


Location Change 


Chapter 2, “What's New or Changed in Novell This section is new. 
QuickFinder,” on page 19 
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